Documentation

Getting Started

API Reference

Plugins

Support

About jQuery

Toolbox

Views

Personal tools

UPDATE: The jQuery API documentation has been completely rewritten and moved to api.jquery.com. More details can be found on the jQuery blog.

API/1.3/Selectors

From jQuery JavaScript Library

(Redirected from Selectors)

Jump to: navigation, search

Name	Type

Basics:

Name	Type
#id	Returns: Array<Element>
Matches a single element with the given id attribute.
element	Returns: Array<Element(s)>
Matches all elements with the given tag name.
.class	Returns: Array<Element(s)>
Matches all elements with the given class.
.class.class	Returns: Array<Element(s)>
Matches all elements with the given classes.
*	Returns: Array<Element(s)>
Matches all elements.
selector1, selector2, selectorN	Returns: Array<Element(s)>
Matches the combined results of all the specified selectors.

Hierarchy:

Name	Type
ancestor descendant	Returns: Array<Element(s)>
Matches a descendant element specified by "descendant" of elements specified by "ancestor".
parent > child	Returns: Array<Element(s)>
Matches all child elements specified by "child" of elements specified by "parent".
prev + next	Returns: Array<Element(s)>
Matches all next elements specified by "next" that are next to elements specified by "prev".
prev ~ siblings	Returns: Array<Element(s)>
Matches all sibling elements after the "prev" element that match the filtering "siblings" selector.

Basic Filters:

Name	Type
:first	Returns: Array<Element>
Matches the first selected element.
:last	Returns: Array<Element>
Matches the last selected element.
:not(selector)	Returns: Array<Element(s)>
Filters out all elements matching the given selector.
:even	Returns: Array<Element(s)>
Matches even elements, zero-indexed. See also odd
:odd	Returns: Array<Element(s)>
Matches odd elements, zero-indexed. See also even.
:eq(index)	Returns: Array<Element>
Matches a single element by its index.
:gt(index)	Returns: Array<Element(s)>
Matches all elements with an index above the given one.
:lt(index)	Returns: Array<Element(s)>
Matches all elements with an index below the given one.
:header	Returns: Array<Element(s)>
Matches all elements that are headers, like h1, h2, h3 and so on.
:animated	Returns: Array<Element(s)>
Matches all elements that are currently being animated.

Content Filters:

Name	Type
:contains(text)	Returns: Array<Element(s)>
Matches elements which contain the given text.
:empty	Returns: Array<Element(s)>
Matches all elements that have no children (including text nodes).
:has(selector)	Returns: Array<Element(s)>
Matches elements which contain at least one element that matches the specified selector.
:parent	Returns: Array<Element(s)>
Matches all elements that are parents - they have child elements, including text.

Visibility Filters:

Name	Type
:hidden	Returns: Array<Element(s)>
Matches all elements that are hidden.
:visible	Returns: Array<Element(s)>
Matches all elements that are visible.

Attribute Filters:Note: In jQuery 1.3 [@attr] style selectors were removed (they were previously deprecated in jQuery 1.2). Simply remove the '@' symbol from your selectors in order to make them work again.

Name	Type
[attribute]	Returns: Array<Element(s)>
Matches elements that have the specified attribute. Note the "@" before the attribute name was deprecated as of version 1.2.
[attribute=value]	Returns: Array<Element(s)>
Matches elements that have the specified attribute with a certain value.
[attribute!=value]	Returns: Array<Element(s)>
Matches elements that either don't have the specified attribute or do have the specified attribute but not with a certain value.
[attribute^=value]	Returns: Array<Element(s)>
Matches elements that have the specified attribute and it starts with a certain value.
[attribute$=value]	Returns: Array<Element(s)>
Matches elements that have the specified attribute and it ends with a certain value.
*[attribute=value]**	Returns: Array<Element(s)>
Matches elements that have the specified attribute and it contains a certain value.
[attributeFilter1][attributeFilter2][attributeFilterN]	Returns: Array<Element(s)>
Matches elements that match all of the specified attribute filters.

Child Filters:

Name	Type
:nth-child(index/even/odd/equation)	Returns: Array<Element(s)>
Matches all elements that are the nth-child of their parent or that are the parent's even or odd children.
:first-child	Returns: Array<Element(s)>
Matches all elements that are the first child of their parent.
:last-child	Returns: Array<Element(s)>
Matches all elements that are the last child of their parent.
:only-child	Returns: Array<Element(s)>
Matches all elements that are the only child of their parent.

Forms:

Name	Type
:input	Returns: Array<Element(s)>
Matches all input, textarea, select and button elements.
:text	Returns: Array<Element(s)>
Matches all elements of type text.
:password	Returns: Array<Element(s)>
Matches all input elements of type password.
:radio	Returns: Array<Element(s)>
Matches all input elements of type radio.
:checkbox	Returns: Array<Element(s)>
Matches all input elements of type checkbox.
:submit	Returns: Array<Element(s)>
Matches all input elements of type submit.
:image	Returns: Array<Element(s)>
Matches all input elements of type image.
:reset	Returns: Array<Element(s)>
Matches all input elements of type reset.
:button	Returns: Array<Element(s)>
Matches all button elements and input elements of type button.
:file	Returns: Array<Element(s)>
Matches all input elements of type file.

Form Filters:

Name	Type
:enabled	Returns: Array<Element(s)>
Matches all elements that are enabled.
:disabled	Returns: Array<Element(s)>
Matches all elements that are disabled.
:checked	Returns: Array<Element(s)>
Matches all elements that are checked. This includes checkboxes and radiobuttons.
:selected	Returns: Array<Element(s)>
Matches all elements that are selected.

[edit]

Special characters in selectors

If you wish to use any of the meta-characters described above as a literal part of a name, you must escape the character with a backslash (\). Since Javascript uses the backslash for escape sequences in string literals, you must use two backslashes (\\) in string literals so that a single backslash will be put into the string 1.

Example:

"#foo\\:bar"
"#foo\\[bar\\]"
"#foo\\.bar"

The full list of characters that need to be escaped: #;&,.+*~':"!^$[]()=>|/

Retrieved from "http://docs.jquery.com/API/1.3/Selectors"

Categories: Selectors/odd | Selectors/even