jQuery 1.6 API 中文版

Selectors

Basics

#id
element
.class, .class.class
*
selector1, selector2

Hierarchy

ancestor descendant
parent > child
prev + next
prev ~ siblings

Basic Filters

:first
:last
:not(selector)
:even
:odd
:eq(index)
:gt(index)
:lt(index)
:header
:animated
:focus 1.6+

Content Filters

:contains(text)
:empty
:has(selector)
:parent

Visibility Filters

:hidden
:visible

Child Filters

:nth-child(expr)
:first-child
:last-child
:only-child

Attribute Filters

[attribute]
[attribute=value]
[attribute!=value]
[attribute^=value]
[attribute$=value]
[attribute*=value]
[attribute|=value]
[attribute~=value]
[attribute][attribute2]

Forms

:input
:text
:password
:radio
:checkbox
:submit
:image
:reset
:button
:file

Form Filters

:enabled
:disabled
:checked
:selected

Core

jQuery function

$. jQuery ( selector [, context] ), . jQuery ( element ), . jQuery ( elementArray ), . jQuery ( jQueryObject ), . jQuery ( )
$. jQuery ( html [, ownerDocument] ), . jQuery ( html, props )
$. jQuery ( fn )
def. when (deferreds)
fn jQuery.sub ( )
$. holdReady ( hold )

jQuery Object Accessors

$ .each ( fn(index, element) )
num .size( ) , .length
str. selector
el. context
$. eq ( index )
jQuery.error ( str )
[el],el. get ( [index] )
num. index ( )index index( selector )indexindex( element )
$ jQuery.pushStack ( elements, [name, arguments] )
arr. toArray ( )

Interoperability

$ jQuery.noConflict ( [extreme] )

Attributes

Attributes

str. attr ( name ) | (name , value ) ) 1.6*
$. attr ( name, val ), . attr ( map ), . attr ( name, fn(index, attr) )
$. removeAttr ( name )
$. prop ( name ) 1.6+
$. removeProp ( name ) 1.6+

Class

$. addClass ( class ), . addClass ( fn(index, class) )
bool. hasClass ( class )
$. removeClass ( [class] ), . removeClass ( fn(index, class) )
$. toggleClass ( class [, switch] ), . toggleClass ( fn(index, class) [, switch] )

HTML, text

str. html ( )
$. html ( val ), . html ( fn(index, html) )
str. text ( )
$. text ( val ), . text ( fn(index, html) )

Value

str,arr. val ( )
$. val ( val ), . val ( fn() )

CSS

CSS

str. css ( name )
$. css ( name, val ), . css ( map ), . css ( name, fn(index, val) )

Positioning

obj. offset ( )
$. offset ( coord ), . offset ( fn( index, coord ) )
$. offsetParent ( )
obj. position ( )
int. scrollTop ( )
$. scrollTop ( val )
int. scrollLeft ( )
$. scrollLeft ( val )

Height and Width

int. height ( )
$. height ( val ), . height ( fn(index, height ) )
int. width ( )
$. width ( val ), .width(( fn(index, height ) )
int. innerHeight ( )
int. innerWidth ( )
int. outerHeight ( [margin] )
int. outerWidth ( [margin] )

Deferred

deferred object = {
def done (doneCallbacks)
def fail (failCallbacks)
bool isRejected ()
bool isResolved ()
def reject ([args])
def rejectWith (context, [args])
def resolve ([args])
def resolveWith (context, [args])
def then (doneCallbacks, failCallbacks)
}
def. promise (deferreds) 1.6+
def. pipe (deferreds) 1.6+
def. always (deferreds) 1.6+

Traversing

Filtering

$. eq ( index )
$. first ( )
$. last ( )
$. has ( selector ), . has ( element )
$. filter ( selector ), . filter ( fn(index) )
bool. is ( selector | function(index) | jQuery object | element ) 1.6*
$. map ( fn(index, element) )
$. not ( selector ), . not ( elements ), . not ( fn( index ) )
$. slice ( start [, end] )

Tree traversal

$. children ( [selector] )
$. closest ( selector [, context] | jQuery object | element ) 1.6*
arr. closest ( selectors [, context] )
$. find ( selector | jQuery object | element ) 1.6*
$. next ( [selector] )
$. nextAll ( [selector] )
$. nextUntil ( [selector] )
$. offsetParent ( )
$. parent ( [selector] )
$. parents ( [selector] )
$. parentsUntil ( [selector] )
$. prev ( [selector] )
$. prevAll ( [selector] )
$. prevUntil ( [selector] )
$. siblings ( [selector] )

Miscellaneous

$. add ( selector [, context] ), . add ( elements ), . add ( html )
$. andSelf ( )
$. contents ( )
$. end ( )

Manipulation

Inserting Inside

$. append ( content ), . append ( fn( index, html ) )
$. appendTo ( target )
$. prepend ( content ), . prepend ( fn( index, html ) )
$. prependTo ( target )

Inserting Outside

$. after ( content ), . after ( fn() )
$. before ( content ), . before ( fn() )
$. insertAfter ( target )
$. insertBefore ( target )

Inserting Around

$. unwrap ( )
$. wrap ( wrappingElement ), . wrap ( fn )
$. wrapAll (wrappingElement ), . wrapAll ( fn )
$. wrapInner ( wrappingElement ), . wrapInner ( fn )

Replacing

$. replaceWith ( content ), . replaceWith ( fn )
$. replaceAll ( selector )

Removing

$. detach ( [selector] )
$. empty ( )
$. remove ( [selector] )

Copying

$. clone ( [withDataAndEvents], [deepWithDataAndEvents] )

Events

Page Load

$. ready ( fn() )

Event Handling

$. bind ( type [, data ], fn(eventObj) )
$. bind ( type [, data], false )
$. bind ( array )
$. unbind ( [type] [, fn])
$. one ( type [, data ], fn(eventObj) )
$. trigger ( event [, data])
obj. triggerHandler ( event [, data])
$. delegate ( selector, type, [data], handler)
$. undelegate ( [selector, type, [handler]]) | ( selector, events ) | ( namespace ) 1.6*

Live Events

$. live ( eventType [, data], fn() )
$. die ( ), . die ( [eventType] [, fn() ])

Interaction Helpers

$. hover ( fnIn(eventObj), fnOut(eventObj))
$. toggle ( fn(eventObj), fn2(eventObj) [, ...])

Event Helpers

function ( [data,] [fn] )
$
. blur,
. change,
. click,
. error,
. focus,
. focusin,
. mouseup,
. resize,
. keydown,
. scroll,
. select,
. keyup,
. submit,
. load ( [data,] fn ),
. unload ( [data,] fn )

Event object

event = {
el currentTarget,
* data,
bool isDefaultPrevented (),
bool isImmediatePropagationStopped (),
bool isPropagationStopped (),
str namespace,
num pageX,
num pageY,
preventDefault (),
el relatedTarget,
obj result,
stopImmediatePropagation (),
stopPropagation (),
el target,
num timeStamp,
str type,
str which
}

Effects

Basics

$. show ( [ duration [, easing] [, fn] ]  )
$. hide ( [ duration [, easing] [, fn] ]  )
$. toggle ( [showOrHide] )
$. toggle ( duration [, easing] [, fn] )

Sliding

$. slideDown ( duration [, easing] [, fn] )
$. slideUp ( duration [, easing] [, fn] )
$. slideToggle ( [duration] [, easing] [, fn] )

Fading

$. fadeIn ( duration [, easing] [, fn] )
$. fadeOut ( duration [, easing] [, fn] )
$. fadeTo ( [duration,] opacity [, easing] [, fn] )
$. fadeToggle ( [duration,] [, easing] [, fn] )

Custom

$. animate ( params [, duration] [, easing] [, fn] )
$. animate ( params, options )
$. stop ( [clearQueue] [, jumpToEnd] )
$. delay ( duration [, queueName] )

Settings

bool jQuery.fx.off
num jQuery.fx.interval

AJAX

Low-Level Interface

jqXHR jQuery.ajax ( options, [settings] )
  • mapaccepts
  • boolasync = true
  • fnbeforeSend( jqXHR, config)
  • boolcache = true
  • fncomplete( jqXHR, status)
  • mapcontents
  • strcontentType
  • objcontext
  • mapconverters
  • boolcrossDomain
  • obj, str data
  • fndataFilter( data, type )
  • boolglobal = true
  • mapheaders
  • boolifModified = false
  • strjsonp
  • fnjsonpCallback
  • strpassword
  • boolprocessData = true
  • strscriptCharset
  • mapstatusCode
  • numtimeout
  • booltraditional
  • strtype = 'GET'
  • strurl = curr. page
  • strusername
  • fnxhr
  • strdataType ∈ {xml, json, script, html}
  • fnerror( jqXHR, status, errorThrown )
  • fnsuccess( data, status, jqXHR )
jQuery.ajaxSetup ( options )

Shorthand Methods

$. load ( url [, data] [, fn( responseText, status, XHR )] )
jqXHR jQuery.get ( url [, data] [, fn( data, status, XHR )] [, type] )
jqXHR jQuery.getJSON ( url [, data] [, fn( data, status )] )
jqXHR jQuery.getScript ( url [, fn( data, status )] )
jqXHR jQuery.post ( url [, data] [, fn( data, status )] [, type] )

Global Ajax Event Handlers

$. ajaxComplete ( fn( event, XHR, options ) )
$. ajaxError ( fn( event, XHR, options, thrownError ) )
$. ajaxSend ( fn( event, XHR, options ) )
$. ajaxStart ( fn(  ) )
$. ajaxStop ( fn(  ) )
$. ajaxSuccess ( fn(event, XHR, options) )

Miscellaneous

str. serialize (  )
[obj]. serializeArray (  )
str jQuery.param ( obj, [traditional] )

Utilities

Browser and Feature Detection

obj jQuery.support
obj jQuery.browser deprecated
str jQuery.browser.version deprecated
bool jQuery.boxModel deprecated

Basic operations

obj jQuery.each ( obj, fn( index, valueOfElement ) )
obj jQuery.extend ( [deep,] target, obj1 [, objN] )
arr jQuery.grep ( array, fn( element, index ) [, invert] )
arr jQuery.makeArray ( obj )
arr jQuery.map ( arrayOrObject, fn( element, index ) ) 1.6*
num jQuery.inArray ( val, array )
arr jQuery.merge ( first, second )
fn jQuery.noop
fn jQuery.proxy ( fn, scope ), jQuery.proxy ( scope, name )
arr jQuery.unique ( array )
str jQuery.trim ( str )
obj jQuery.parseJSON ( str )

Data functions

$. clearQueue ( [name] )
$. dequeue ( [name] ), jQuery.dequeue ( [name] )
obj jQuery.data ( element, key ), jQuery.data (  )
obj. data (  ), . data ( key )
$. data ( key, val ), . data ( obj )
$. removeData ( [name] )
[fn]. queue ( [name] ) jQuery.queue ( [name] )
$. queue ( [name,] fn( next ) ), jQuery.queue ( [name,] fn(  ) )
$. queue ( [name,] queue ), jQuery.queue ( [name,] queue )

Test operations

str jQuery.type ( obj )
bool jQuery.isArray ( obj )
bool jQuery.isEmptyObject ( obj )
bool jQuery.isFunction ( obj )
bool jQuery.isPlainObject ( obj )
bool jQuery.isWindow ( obj )

下载jQuery 1.6 API 中文版

反馈和联系

腾讯微薄:@julying

Email:i[a]julying.com

主页 http://julying.com

本作品由 愚人码头 翻译,由 脚本之家 整理、修订