jQuery 1.6 API Chinese version

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

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

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 (a)

bool isResolved (a)

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,

. mousedown,

. change,

. mouseenter,

. click,

. mouseleave,

. dblclick,

. mousemove,

. error,

. mouseout,

. focus,

. mouseover,

. focusin,

. mouseup,

. focusout,

. resize,

. keydown,

. scroll,

. keypress,

. select,

. keyup,

. submit,

. load ( [data,] fn ),

. unload ( [data,] fn )

Event object

event = {

el currentTarget,

* data,

bool isDefaultPrevented (a),

bool isImmediatePropagationStopped (a),

bool isPropagationStopped (a),

str namespace,

num pageX,

num pageY,

preventDefault (a),

el relatedTarget,

obj result,

stopImmediatePropagation (a),

stopPropagation (a),

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
The content type sent in the request header that tells the server what kind of response it will accept in return.
boolasync = true
By default, all requests are sent asynchronous.
fnbeforeSend( jqXHR, config)
A pre-request callback function that can be used to modify the jqXHR object before it is sent.
boolcache = true
If set to false it will force the pages that you request to not be cached by the browser.
fncomplete( jqXHR, status)
A function to be called when the request finishes (after success and error callbacks are executed).
mapcontents
A map of string/regular-expression pairs that determine how jQuery will parse the response, given its content type.
strcontentType
When sending data to the server, use this content-type. Default is "application/x-www-form-urlencoded", which is fine for most cases.
objcontext
This object will be made the context of all Ajax-related callbacks.
mapconverters
A map of dataType-to-dataType converters. Each converter's value is a function that returns the transformed value of the response.
boolcrossDomain
If you wish to force a crossDomain request (such as JSONP) on the same domain, set the value of crossDomain to true.
obj, str data
Data to be sent to the server. It is converted to a query string, if not already a string.
fndataFilter( data, type )
A function to be used to handle the raw responsed data of XMLHttpRequest.This is a pre-filtering function to sanitize the response.
boolglobal = true
Whether to trigger global Ajax event handlers for this request.
mapheaders
A map of additional header key/value pairs to send along with the request.
boolifModified = false
Allow the request to be successful only if the response has changed since the last request.
strjsonp
Override the callback function name in a jsonp request.
fnjsonpCallback
Specify the callback function name for a jsonp request.
strpassword
A password to be used in response to an HTTP access authentication request.
boolprocessData = true
By default, data passed in to the data option as an object will be processed and transformed into a query string, fitting to the default content-type "application/x-www-form-urlencoded".
strscriptCharset
Forces the request to be interpreted as a certain charset.
mapstatusCode
A map of numeric HTTP codes and functions to be called when the response has the corresponding code.
numtimeout
Set a local timeout (in milliseconds) for the request.
booltraditional
Set this to true if you wish to use the traditional style of param serialization.
strtype = 'GET'
The type of request to make ("POST" or "GET"), default is "GET".
strurl = curr. page
A string containing the URL to which the request is sent.
strusername
A username to be used in response to an HTTP access authentication request.
fnxhr
Callback for creating the XMLHttpRequest object.
strdataType ∈ {xml, json, script, html}
The type of data that you're expecting back from the server.
fnerror( jqXHR, status, errorThrown )
A function to be called if the request fails.
fnsuccess( data, status, jqXHR )
A function to be called if the request succeeds.

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 )

Download the jQuery 1.6 API Chinese version

JQuery 1.6 API download English version download jQuery 1.6 API Chinese version at http://www.jb51.net/books/39318.html
jQuery 1.6 API Chinese version [Online version] : jQuery 1.6 API Chinese version (for jQuery 1.6 and jQuery 1.6.1,jQuery 1.6.2)
jQuery 1.6 API - Alternative jQuery Documentation(For jQuery 1.6 and jQuery 1.6.1, jQuery 1.6.2)

Feedback and contact

Tencent microblog: @julying

Email: i[a]julying.com

Home page http://julying.com

This work has been translated by Fool's Wharf and edited and revised by Script House