Selectors
Basics
* Selects all elements.
.class Selects all elements with the given class.
element Selects all elements with the given tag name.
#id Selects a single element with the given id attribute.
selector1, selectorN, ... Selects the combined results of all the specified selectors.
Hierarchy
parent > child Selects all direct child elements specified by 'child' of elements specified by 'parent'.
ancestor descendant Selects all elements that are descendants of a given ancestor.
prev + next Selects all next elements matching 'next' that are immediately preceded by a sibling 'prev'.
prev ~ siblings Selects all sibling elements that follow after the 'prev' element, have the same parent, and match the filtering 'siblings' selector.
Basic Filters
:animated Select all elements that are in the progress of an animation at the time the selector is run.
:eq() Select the element at index n within the matched set.
:even Selects even elements, zero-indexed. See also odd.
:first Selects the first matched element.
:gt() Select all elements at an index greater than index within the matched set.
:header Selects all elements that are headers, like h1, h2, h3 and so on.
:lang() Selects all elements of the specified language.
:last Selects the last matched element.
:lt() Select all elements at an index less than index within the matched set.
:not() Selects all elements that do not match the given selector.
:odd Selects odd elements, zero-indexed. See also even.
:root Selects the element that is the root of the document.
:target Selects the target element indicated by the fragment identifier of the document's URI.
Content Filters
:contains() Select all elements that contain the specified text.
:empty Select all elements that have no children (including text nodes).
:has() Selects elements which contain at least one element that matches the specified selector.
:parent Select all elements that are the parent of another element, including text nodes.
Visibility Filters
:hidden Selects all elements that are hidden.
:visible Selects all elements that are visible.
Attribute
[name|="value"] Selects elements that have the specified attribute with a value either equal to a given string or starting with that string followed by a hyphen (-).
[name*="value"] Selects elements that have the specified attribute with a value containing the a given substring.
[name~="value"] Selects elements that have the specified attribute with a value containing a given word, delimited by spaces.
[name$="value"] Selects elements that have the specified attribute with a value ending exactly with a given string. The comparison is case sensitive.
[name="value"] Selects elements that have the specified attribute with a value exactly equal to a certain value.
[name!="value"] Select elements that either don't have the specified attribute, or do have the specified attribute but not with a certain value.
[name^="value"] Selects elements that have the specified attribute with a value beginning exactly with a given string.
[name] Selects elements that have the specified attribute, with any value.
[name="value"][name2="value2"] Matches elements that match all of the specified attribute filters.
Child Filters
:first-child Selects all elements that are the first child of their parent.
:first-of-type Selects all elements that are the first among siblings of the same element name.
:last-child Selects all elements that are the last child of their parent.
:last-of-type Selects all elements that are the last among siblings of the same element name.
:nth-child() Selects all elements that are the nth-child of their parent.
:nth-last-child() Selects all elements that are the nth-child of their parent, counting from the last element to the first.
:nth-last-of-type() Selects all elements that are the nth-child of their parent, counting from the last element to the first.
:nth-of-type() Selects all elements that are the nth child of their parent in relation to siblings with the same element name.
:only-child Selects all elements that are the only child of their parent.
:only-of-type() Selects all elements that have no siblings with the same element name.
Forms
:button Selects all button elements and elements of type button.
:checkbox Selects all elements of type checkbox.
:checked Matches all elements that are checked.
:disabled Selects all elements that are disabled.
:enabled Selects all elements that are enabled.
:focus Selects element if it is currently focused.
:file Selects all elements of type file.
:image Selects all elements of type image.
:input Selects all input, textarea, select and button elements.
:password Selects all elements of type password.
:radio Selects all elements of type radio.
:reset Selects all elements of type reset.
:selected Selects all elements that are selected.
:submit Selects all elements of type submit.
:text Selects all elements of type text.
Attributes / CSS
Attributes
.attr() Get the value of an attribute for the first element in the set of matched elements or set one or more attributes for every matched element.
.prop() Get the value of a property for the first element in the set of matched elements or set one or more properties for every matched element.
.removeAttr() Remove an attribute from each element in the set of matched elements.
.removeProp() Remove a property for the set of matched elements.
.val() Get the current value of the first element in the set of matched elements or set the value of every matched element.
CSS
.addClass() Adds the specified class(es) to each of the set of matched elements.
.css() Get the value of a style property for the first element in the set of matched elements or set one or more CSS properties for every matched element.
jQuery.cssHooks Provides a way to hook directly into jQuery to override how particular CSS properties are retrieved or set. Amongst other uses, cssHooks can be used to create custom, browser-normalized properties for CSS3 features such as box-shadows and gradients.
jQuery.cssNumber An object containing all CSS properties that may be used without a unit. The .css() method uses this object to see if it may append px to unitless values..
jQuery.escapeSelector() Escapes any character that has a special meaning in a CSS selector.
.hasClass() Determine whether any of the matched elements are assigned the given class.
.removeClass() Remove a single class, multiple classes, or all classes from each element in the set of matched elements.
.toggleClass() Add or remove one or more classes from each element in the set of matched elements, depending on either the class's presence or the value of the switch argument.
Dimensions
.height() Get the current computed height for the first element in the set of matched elements or set the height of every matched element.
.innerHeight() Get the current computed height for the first element in the set of matched elements, including padding but not border.
.innerWidth() Get the current computed width for the first element in the set of matched elements, including padding but not border.
.outerHeight() Get the current computed height for the first element in the set of matched elements, including padding, border, and optionally margin.
.outerWidth() Get the current computed width for the first element in the set of matched elements, including padding and border.
.width() Get the current computed width for the first element in the set of matched elements or set the width of every matched element.
Offset
.offset() Get the current coordinates of the first element, or set the coordinates of every element, in the set of matched elements, relative to the document.
.offsetParent() Get the closest ancestor element that is positioned.
.position() Get the current coordinates of the first element in the set of matched elements, relative to the offset parent.
.scrollLeft() Get the current horizontal position of the scroll bar for the first element in the set of matched elements or set the horizontal position of the scroll bar for every matched element.
.scrollTop() Get the current vertical position of the scroll bar for the first element in the set of matched elements or set the vertical position of the scroll bar for every matched element.
Data
jQuery.data() Store arbitrary data associated with the specified element and/or return the value that was set.
.data() Store arbitrary data associated with the matched elements or return the value at the named data store for the first element in the set of matched elements.
jQuery.hasData() Determine whether an element has any jQuery data associated with it.
jQuery.removeData() Remove a previously-stored piece of data.
.removeData() Remove a previously-stored piece of data.
Manipulation
Copying
.clone() Create a deep copy of the set of matched elements.
DOM Insertion, Around
.wrap() Wrap an HTML structure around each element in the set of matched elements.
.wrapAll() Wrap an HTML structure around all elements in the set of matched elements.
.wrapInner() Wrap an HTML structure around the content of each element in the set of matched elements.
DOM Insertion, Inside
.append() Insert content, specified by the parameter, to the end of each element in the set of matched elements.
.appendTo() Insert every element in the set of matched elements to the end of the target.
.html() Get the HTML contents of the first element in the set of matched elements or set the HTML contents of every matched element.
.prepend() Insert content, specified by the parameter, to the beginning of each element in the set of matched elements.
.prependTo() Insert every element in the set of matched elements to the beginning of the target.
.text() Get the combined text contents of each element in the set of matched elements, including their descendants, or set the text contents of the matched elements.
DOM Insertion, Outside
.after() Insert content, specified by the parameter, after each element in the set of matched elements.
.before() Insert content, specified by the parameter, before each element in the set of matched elements.
.insertAfter() Insert every element in the set of matched elements after the target.
.insertBefore() Insert every element in the set of matched elements before the target.
DOM Removal
.detach() Remove the set of matched elements from the DOM.
.empty() Remove all child nodes of the set of matched elements from the DOM.
.remove() Remove the set of matched elements from the DOM.
.unwrap() Remove the parents of the set of matched elements from the DOM, leaving the matched elements in their place.
DOM Replacement
.replaceAll() Replace each target element with the set of matched elements.
.replaceWith() Replace each element in the set of matched elements with the provided new content.
Traversing
Filtering
.eq() Reduce the set of matched elements to the one at the specified index.
.even() Reduce the set of matched elements to the even ones in the set, numbered from zero.
.filter() Reduce the set of matched elements to those that match the selector or pass the function's test.
.first() Reduce the set of matched elements to the first in the set.
.has() Reduce the set of matched elements to those that have a descendant that matches the selector or DOM element.
.is() Check the current matched set of elements against a selector and return true if at least one of these elements matches the selector.
.last() Reduce the set of matched elements to the final one in the set.
.map() Pass each element in the current matched set through a function, producing a new jQuery object containing the return values.
.not() Remove elements from the set of matched elements.
.odd() Reduce the set of matched elements to the odd ones in the set, numbered from zero.
.slice() Reduce the set of matched elements to a subset specified by a range of indices.
Miscellaneous Traversing
.add() Add elements to the set of matched elements.
.addBack() Add the previous set of elements on the stack to the current set, optionally filtered by a selector.
.andSelf() Add the previous set of elements on the stack to the current set.
.contents() Get the children of each element in the set of matched elements, including text and comment nodes.
.each() Iterate over a jQuery object, executing a function for each matched element.
.end() End the most recent filtering operation in the current chain and return the set of matched elements to its previous state.
.uniqueSort() Sorts a jQuery object of DOM elements, in place, with the duplicates removed. Note that this only works on jQuery objects consisting of DOM elements, not strings or numbers.
Tree Traversal
.children() Get the children of each element in the set of matched elements, optionally filtered by a selector.
.closest() Get the first ancestor element that matches the selector, beginning at the current element and progressing up through the DOM tree.
.find() Get the descendants of each element in the current set of matched elements, filtered by a selector.
.next() Get the immediately following sibling of each element in the set of matched elements. If a selector is provided, it retrieves the next sibling only if it matches that selector.
.nextAll() Get all following siblings of each element in the set of matched elements, optionally filtered by a selector.
.nextUntil() Get all following siblings of each element up to but not including the element matched by the selector.
.parent() Get the parent of each element in the current set of matched elements, optionally filtered by a selector.
.parents() Get the ancestors of each element in the current set of matched elements, optionally filtered by a selector.
.parentsUntil() Get the ancestors of each element in the current set of matched elements, up to but not including the element matched by the selector.
.prev() Get the immediately preceding sibling of each element in the set of matched elements, optionally filtered by a selector.
.prevAll() Get all preceding siblings of each element in the set of matched elements, optionally filtered by a selector.
.prevUntil() Get all preceding siblings of each element up to but not including the element matched by the selector.
.siblings() Get the siblings of each element in the set of matched elements, optionally filtered by a selector.
Events
Browser Events
.error() Bind an event handler to the 'error' JavaScript event.
.resize() Bind an event handler to the 'resize' JavaScript event, or trigger that event on an element.
.scroll() Bind an event handler to the 'scroll' JavaScript event, or trigger that event on an element.
Document Loading
.load() Bind an event handler to the 'load' JavaScript event.
.ready() Specify a function to execute when the DOM is fully loaded.
.unload() Bind an event handler to the 'unload' JavaScript event.
Event Handler Attachment
.bind() Attach a handler to an event for the elements.
.delegate() Attach a handler to one or more events for all elements that match the selector, now or in the future, based on a specific set of root elements.
.die() Remove all event handlers previously attached using .live() from the elements.
.live() Attach a handler to the event for all elements which match the current selector, now and in the future.
.off() Remove an event handler.
.on() Attach an event handler function for one or more events to the selected elements.
.one() Attach a handler to an event for the elements. The handler is executed at most once per element.
.trigger() Execute all handlers and behaviors attached to the matched elements for the given event type.
.triggerHandler() Execute all handlers attached to an element for an event.
.unbind() Remove a previously-attached event handler from the elements.
.undelegate() Remove a handler from the event for all elements which match the current selector, now or in the future, based upon a specific set of root elements.
Form Events
.blur() Bind an event handler to the 'blur' JavaScript event, or trigger that event on an element.
.change() Bind an event handler to the 'change' JavaScript event, or trigger that event on an element.
.focus() Bind an event handler to the 'focus' JavaScript event, or trigger that event on an element.
.focusin() Bind an event handler to the 'focusin' JavaScript event.
.focusout() Bind an event handler to the 'focusout' JavaScript event.
.select() Bind an event handler to the 'select' JavaScript event, or trigger that event on an element.
.submit() Bind an event handler to the 'submit' JavaScript event, or trigger that event on an element.
Keyboard Events
.keydown() Bind an event handler to the 'keydown' JavaScript event, or trigger that event on an element.
.keypress() Bind an event handler to the 'keypress' JavaScript event, or trigger that event on an element.
.keyup() Bind an event handler to the 'keyup' JavaScript event, or trigger that event on an element.
Mouse Events
.click() Bind an event handler to the 'click' JavaScript event, or trigger that event on an element.
.contextMenu() Bind an event handler to the 'contextmenu' JavaScript event, or trigger that event on an element.
.dblclick() Bind an event handler to the 'dblclick' JavaScript event, or trigger that event on an element.
.hover() Bind two handlers to the matched elements, to be executed when the mouse pointer enters and leaves the elements.
.mousedown() Bind an event handler to the 'mousedown' JavaScript event, or trigger that event on an element.
.mouseenter() Bind an event handler to be fired when the mouse enters an element, or trigger that handler on an element.
.mouseleave() Bind an event handler to be fired when the mouse leaves an element, or trigger that handler on an element.
.mousemove() Bind an event handler to the 'mousemove' JavaScript event, or trigger that event on an element.
.mouseout() Bind an event handler to the 'mouseout' JavaScript event, or trigger that event on an element.
.mouseover() Bind an event handler to the 'mouseover' JavaScript event, or trigger that event on an element.
.mouseup() Bind an event handler to the 'mouseup' JavaScript event, or trigger that event on an element.
.toggle() Bind two or more handlers to the matched elements, to be executed on alternate clicks.
Event Object
event.currentTarget The current DOM element within the event bubbling phase.
event.delegateTarget The element where the currently-called jQuery event handler was attached.
event.data The optional data passed to jQuery.fn.bind when the current executing handler was bound.
event.isDefaultPrevented() Returns whether event.preventDefault() was ever called on this event object.
event.isImmediatePropagationStopped() Returns whether event.stopImmediatePropagation() was ever called on this event object.
event.isPropagationStopped() Returns whether event.stopPropagation() was ever called on this event object.
event.metaKey Indicates whether the META key was pressed when the event fired.
event.namespace The namespace specified when the event was triggered.
event.pageX The mouse position relative to the left edge of the document.
event.pageY The mouse position relative to the top edge of the document.
event.preventDefault() If this method is called, the default action of the event will not be triggered.
event.relatedTarget The other DOM element involved in the event, if any.
event.result The last value returned by an event handler that was triggered by this event, unless the value was undefined.
event.stopImmediatePropagation() Prevents other event handlers from being called.
event.stopPropagation() Prevents the event from bubbling up the DOM tree, preventing any parent handlers from being notified of the event.
event.target The DOM element that initiated the event.
event.timeStamp The difference in milliseconds between the time an event is triggered and January 1, 1970.
event.type Describes the nature of the event.
event.which For key or button events, this attribute indicates the specific button or key that was pressed.
Effects
Basics
.hide() Hide the matched elements.
.show() Display the matched elements.
.toggle() Display or hide the matched elements.
Custom
.animate() Perform a custom animation of a set of CSS properties.
.clearQueue() Remove from the queue all items that have not yet been run.
.delay() Set a timer to delay execution of subsequent items in the queue.
.dequeue() Execute the next function on the queue for the matched elements.
jQuery.dequeue() Execute the next function on the queue for the matched element.
.finish() Stop the currently-running animation, remove all queued animations, and complete all animations for the matched elements.
jQuery.fx.interval The rate (in milliseconds) at which animations fire.
jQuery.fx.off Globally disable all animations.
jQuery.speed Creates an object containing a set of properties ready to be used in the definition of custom animations.
.queue() Show or manipulate the queue of functions to be executed on the matched elements.
jQuery.queue() Show or manipulate the queue of functions to be executed on the matched element.
.stop() Stop the currently-running animation on the matched elements.
Fading
.fadeIn() Display the matched elements by fading them to opaque.
.fadeOut() Hide the matched elements by fading them to transparent.
.fadeTo() Adjust the opacity of the matched elements.
.fadeToggle() Display or hide the matched elements by animating their opacity.
Sliding
.slideDown() Display the matched elements with a sliding motion.
.slideToggle() Display or hide the matched elements with a sliding motion.
.slideUp() Hide the matched elements with a sliding motion.
Ajax
Global Ajax Event Handlers
.ajaxComplete() Register a handler to be called when Ajax requests complete. This is an Ajax Event.
.ajaxError() Register a handler to be called when Ajax requests complete with an error. This is an Ajax Event.
.ajaxSend() Attach a function to be executed before an Ajax request is sent. This is an Ajax Event.
.ajaxStart() Register a handler to be called when the first Ajax request begins. This is an Ajax Event.
.ajaxStop() Register a handler to be called when all Ajax requests have completed. This is an Ajax Event.
.ajaxSuccess() Attach a function to be executed whenever an Ajax request completes successfully. This is an Ajax Event.
Helper Functions
jQuery.param() Create a serialized representation of an array or object, suitable for use in a URL query string or Ajax request.
.serialize() Encode a set of form elements as a string for submission.
.serializeArray() Encode a set of form elements as an array of names and values.
Low-Level Interface
jQuery.ajax() Perform an asynchronous HTTP (Ajax) request.
jQuery.prefilter() Handle custom Ajax options or modify existing options before each request is sent and before they are processed by $.ajax().
jQuery.ajaxSetup() Set default values for future Ajax requests.
jQuery.ajaxTransport() Creates an object that handles the actual transmission of Ajax data.
Shorthand Methods
jQuery.get() Load data from the server using a HTTP GET request.
jQuery.getJSON() Load JSON-encoded data from the server using a GET HTTP request.
jQuery.getScript() Load a JavaScript file from the server using a GET HTTP request, then execute it.
jQuery.post() Load data from the server using a HTTP POST request.
.load() Load data from the server and place the returned HTML into the matched element.
Core
jQuery Object
jQuery() Return a collection of matched elements either found in the DOM based on passed argument(s) or created by passing an HTML string.
jQuery.noConflict() Relinquish jQuery's control of the $ variable.
jQuery.readyException() Handles errors thrown synchronously in functions wrapped in jQuery().
jQuery.sub() Creates a new copy of jQuery whose properties and methods can be modified without affecting the original jQuery object.
jQuery.holdReady() Holds or releases the execution of jQuery's ready event.
jQuery.when() Provides a way to execute callback functions based on one or more objects, usually Deferred objects that represent asynchronous events.
Deferred Object
jQuery.Deferred() A factory function that returns a chainable utility object with methods to register multiple callbacks into callback queues, invoke callback queues, and relay the success or failure state of any synchronous or asynchronous function.
jQuery.Deferred.getErrorHook() Return an Error instance with a defined stack.
deferred.always() Add handlers to be called when the Deferred object is either resolved or rejected.
deferred.done() Add handlers to be called when the Deferred object is resolved.
deferred.fail() Add handlers to be called when the Deferred object is rejected.
deferred.isRejected() Determine whether a Deferred object has been rejected.
deferred.isResolved() Determine whether a Deferred object has been resolved.
deferred.notify() Call the progressCallbacks on a Deferred object with the given args.
deferred.notifyWith() Call the progressCallbacks on a Deferred object with the given context and args.
deferred.pipe() Utility method to filter and/or chain Deferreds.
deferred.progress() Add handlers to be called when the Deferred object generates progress notifications.
deferred.promise() Return a Deferred's Promise object.
deferred.reject() Reject a Deferred object and call any failCallbacks with the given args.
deferred.rejectWith() Reject a Deferred object and call any failCallbacks with the given context and args.
deferred.resolve() Resolve a Deferred object and call any doneCallbacks with the given args.
deferred.resolveWith() Resolve a Deferred object and call any doneCallbacks with the given context and args.
deferred.state() Determine the current state of a Deferred object.
deferred.then() Add handlers to be called when the Deferred object is resolved or rejected.
.promise() Return a Promise object to observe when all actions of a certain type bound to the collection, queued or not, have finished.
Utilities
jQuery.boxModel States if the current page, in the user's browser, is being rendered using the W3C CSS Box Model.
jQuery.browser Contains flags for the useragent, read from navigator.userAgent. We recommend against using this property; please try to use feature detection instead (see jQuery.support). jQuery.browser may be moved to a plugin in a future release of jQuery.
jQuery.contains() Check to see if a DOM node is within another DOM node.
jQuery.each() A generic iterator function, which can be used to seamlessly iterate over both objects and arrays. Arrays and array-like objects with a length property (such as a function's arguments object) are iterated by numeric index, from 0 to length-1. Other objects are iterated via their named properties.
jQuery.extend() Merge the contents of two or more objects together into the first object.
jQuery.globalEval() Execute some JavaScript code globally.
jQuery.grep() Finds the elements of an array which satisfy a filter function. The original array is not affected.
jQuery.inArray() Search for a specified value within an array and return its index (or -1 if not found).
jQuery.isArray() Determine whether the argument is an array.
jQuery.isEmptyObject() Check to see if an object is empty (contains no properties).
jQuery.isFunction() Determine if the argument passed is a Javascript function object.
jQuery.isNumeric() Determines whether its argument is a number.
jQuery.isPlainObject() Check to see if an object is a plain object (created using '{}' or 'new Object').
jQuery.isWindow() Determine whether the argument is a window.
jQuery.isXMLDoc() Check to see if a DOM node is within an XML document (or is an XML document).
jQuery.makeArray() Convert an array-like object into a true JavaScript array.
jQuery.map() Translate all items in an array or array-like object to another array of items.
jQuery.merge() Merge the contents of two arrays together into the first array.
jQuery.noop() An empty function.
jQuery.now() Return a number representing the current time.
jQuery.parseHTML() Parses a string into an array of DOM nodes.
jQuery.parseJSON() Takes a well-formed JSON string and returns the resulting JavaScript object.
jQuery.parseXML() Parses a string into an XML document.
jQuery.proxy() Takes a function and returns a new one that will always have a particular context.
jQuery.support A collection of properties that represent the presence of different browser features or bugs.
jQuery.trim() Remove the whitespace from the beginning and end of a string.
jQuery.type() Determine the internal JavaScript [[Class]] of an object.
jQuery.unique() Sorts an array of DOM elements, in place, with the duplicates removed. Note that this only works on arrays of DOM elements, not strings or numbers.
jQuery.uniqueSort() Sorts an array of DOM elements, in place, with the duplicates removed. Note that this only works on arrays of DOM elements, not strings or numbers.
DOM Element Methods
.get() Retrieve the DOM elements matched by the jQuery object.
.index() Search for a given element from among the matched elements.
.size() Return the number of elements in the jQuery object.
.toArray() Retrieve all the DOM elements contained in the jQuery set, as an array.
Internals
.jquery A string containing the jQuery version number.
.context The DOM node context originally passed to jQuery(); if none was passed then context will likely be the document.
jQuery.error() Takes a string and throws an exception containing it.
.length The number of elements in the jQuery object.
.pushStack() Add a collection of DOM elements onto the jQuery stack.
.selector A selector representing selector originally passed to jQuery().
Callbacks Object
jQuery.Callbacks() A multi-purpose callbacks list object that provides a powerful way to manage callback lists.
callbacks.add() Add a callback or a collection of callbacks to a callback list.
callbacks.disable() Disable a callback list from doing anything more.
callbacks.disabled() Determine if the callbacks list has been disabled.
callbacks.empty() Remove all of the callbacks from a list.
callbacks.fire() Call all of the callbacks with the given arguments.
callbacks.fired() Determine if the callbacks have already been called at least once.
callbacks.fireWith() Call all callbacks in a list with the given context and arguments.
callbacks.has() Determine whether a supplied callback is in a list.
callbacks.lock() Lock a callback list in its current state.
callbacks.locked() Determine if the callbacks list has been locked.
callbacks.remove() Remove a callback or a collection of callbacks from a callback list.