jQuery: The Write Less, Do More JavaScript Library

API/1.2/Selectors

From jQuery JavaScript Library

(Redirected from Selectors)
Jump to: navigation, search

NameType
Basics:

NameType
#id Returns: Element
Matches a single element with the given id attribute.
element Returns: Array<Element>
Matches all elements with the given name.
.class Returns: Array<Element>
Matches all elements with the given class.
* Returns: Array<Element>
Matches all elements.
selector1, selector2, selectorN Returns: Array<Element>
Matches the combined results of all the specified selectors.
Hierarchy:

NameType
ancestor descendant Returns: Array<Element>
Matches all descendant elements specified by "descendant" of elements specified by "ancestor".
parent > child Returns: Array<Element>
Matches all child elements specified by "child" of elements specified by "parent".
prev + next Returns: Array<Element>
Matches all next elements specified by "next" that are next to elements specified by "prev".
prev ~ siblings Returns: Array<Element>
Matches all sibling elements after the "prev" element that match the filtering "siblings" selector.
Basic Filters:

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

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

NameType
:hidden Returns: Array<Element>
Matches all elements that are hidden, or input elements of type "hidden".
:visible Returns: Array<Element>
Matches all elements that are visible.
Attribute Filters:

NameType
[attribute] Returns: Array<Element>
Matches elements that have the specified attribute.
[attribute=value] Returns: Array<Element>
Matches elements that have the specified attribute with a certain value.
[attribute!=value] Returns: Array<Element>
Matches elements that don't have the specified attribute with a certain value.
[attribute^=value] Returns: Array<Element>
Matches elements that have the specified attribute and it starts with a certain value.
[attribute$=value] Returns: Array<Element>
Matches elements that have the specified attribute and it ends with a certain value.
[attribute*=value] Returns: Array<Element>
Matches elements that have the specified attribute and it contains a certain value.
[selector1][selector2][selectorN] Returns: Array<Element>
Matches elements that have the specified attribute and it contains a certain value.
Child Filters:

NameType
:nth-child(index/even/odd/equation) Returns: Array<Element>
Matches the nth-child of its parent or all its even or odd children.
:first-child Returns: Array<Element>
Matches the first child of its parent.
:last-child Returns: Array<Element>
Matches the last child of its parent.
:only-child Returns: Array<Element>
Matches the only child of its parent.
Forms:

NameType
:input Returns: Array<Element>
Matches all input, textarea, select and button elements.
:text Returns: Array<Element>
Matches all input elements of type text.
:password Returns: Array<Element>
Matches all input elements of type password.
:radio Returns: Array<Element>
Matches all input elements of type radio.
:checkbox Returns: Array<Element>
Matches all input elements of type checkbox.
:submit Returns: Array<Element>
Matches all input elements of type submit.
:image Returns: Array<Element>
Matches all input elements of type image.
:reset Returns: Array<Element>
Matches all input elements of type reset.
:button Returns: Array<Element>
Matches all input elements of type button.
:file Returns: Array<Element>
Matches all input elements of type file.
:hidden Returns: Array<Element>
Matches all elements that are hidden, or input elements of type "hidden".
Form Filters:

NameType
:enabled Returns: Array<Element>
Matches all elements that are enabled.
:disabled Returns: Array<Element>
Matches all elements that are disabled.
:checked Returns: Array<Element>
Matches all elements that are checked.
:selected Returns: Array<Element>
Matches all elements that are selected.

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