add(expr)
把与表达式匹配的元素添加到jQuery对象中。这个函数可以用于连接分别与两个表达式匹配的元素结果集。
Adds more elements, matched by the given expression, to the set of matched elements.
返回值
jQuery
参数
expr (String, DOMElement, Array) : 用于匹配元素并添加的表达式字符串,或者用于动态生成的HTML代码,如果是一个字符串数组则返回多个元素
示例
添加一个新元素到一组匹配的元素中,并且这个新元素能匹配给定的表达式。
HTML 代码:
jQuery 代码:
$("p").add("span")
结果:
动态生成一个元素并添加至匹配的元素中
HTML 代码:
jQuery 代码:
$("p").add("Again")
结果:
为匹配的元素添加一个或者多个元素
HTML 代码:
jQuery 代码:
$("p").add(document.getElementById("a"))
结果:
[
Hello
,
Hello Again
,
Hello Again ]
----------------------------------------------------------------------------------------------------------------
children([expr])
取得一个包含匹配的元素集合中每一个元素的所有子元素的元素集合。
可以通过可选的表达式来过滤所匹配的子元素。注意:parents()将查找所有祖辈元素,而children()之考虑子元素而不考虑所有后代元素。
Get a set of elements containing all of the unique children of each of the matched set of elements.
This set can be filtered with an optional expression that will cause only elements matching the selector to be collected. Also note: while parents() will look at all ancestors, children() will only consider immediate child elements.
返回值
jQuery
参数
expr (String) : (可选) 用以过滤子元素的表达式
示例
查找DIV中的每个子元素。
HTML 代码:
Hello
Hello Again
And Again
jQuery 代码:
$("div").children()
结果:
[ Hello Again ]
在每个div中查找 .selected 的类。
HTML 代码:
HelloHello Again
And Again
jQuery 代码:
$("div").children(".selected")
结果:
----------------------------------------------------------------------------------------------------------------
contents()
查找匹配元素内部所有的子节点(包括文本节点)。如果元素是一个iframe,则查找文档内容
Find all the child nodes inside the matched elements (including text nodes), or the content document, if the element is an iframe.
返回值
jQuery
示例
查找所有文本节点并加粗
HTML 代码:
Hello John, how are you doing?
jQuery 代码:
$("p").contents().not("[@nodeType=1]").wrap("");
结果:
Hello John, how are you doing?
往一个空框架中加些内容
HTML 代码:
jQuery 代码:
$("iframe").contents().find("body") .append("I'm in an iframe!");
----------------------------------------------------------------------------------------------------------------
find(expr)
搜索所有与指定表达式匹配的元素。这个函数是找出正在处理的元素的后代元素的好方法。
所有搜索都依靠jQuery表达式来完成。这个表达式可以使用CSS1-3的选择器语法来写。
Searches for all elements that match the specified expression. This method is a good way to find additional descendant elements with which to process.
All searching is done using a jQuery expression. The expression can be written using CSS 1-3 Selector syntax.
返回值
jQuery
参数
expr (String) :用于查找的表达式
示例
从所有的段落开始,进一步搜索下面的span元素。与$("p span")相同。
HTML 代码:
jQuery 代码:
$("p").find("span")
结果:
[ Hello ]
----------------------------------------------------------------------------------------------------------------
next([expr])
取得一个包含匹配的元素集合中每一个元素紧邻的后面同辈元素的元素集合。
这个函数只返回后面那个紧邻的同辈元素,而不是后面所有的同辈元素(可以使用nextAll)。可以用一个可选的表达式进行筛选。
Get a set of elements containing the unique next siblings of each of the matched set of elements.
It only returns the very next sibling for each element, not all next siblings (nor does it return the next closest sibling). You may provide an optional expression to filter the match.
返回值
jQuery
参数
expr (String) : (可选) 用于筛选的表达式
示例
找到每个段落的后面紧邻的同辈元素。
HTML 代码:
Hello
Hello Again
And Again
jQuery 代码:
$("p").next()
结果:
[
Hello Again
,
And Again
]
找到每个段落的后面紧邻的同辈元素中类名为selected的元素。
HTML 代码:
Hello
Hello Again
And Again
jQuery 代码:
$("p").next(".selected")
结果:
----------------------------------------------------------------------------------------------------------------
nextAll([expr])
Find all sibling elements after the current element.
Use an optional expression to filter the matched set.
返回值
jQuery
参数
expr (String) : (可选)用来过滤的表达式
示例
给第一个div之后的所有元素加个类
HTML 代码:
jQuery 代码:
$("div:first").nextAll().addClass("after");
结果:
----------------------------------------------------------------------------------------------------------------
parent([expr])
取得一个包含着所有匹配元素的唯一父元素的元素集合。
你可以使用可选的表达式来筛选。
Get a set of elements containing the unique parents of the matched set of elements.
You may use an optional expression to filter the set of parent elements that will match.
返回值
jQuery
参数
expr (String) : (可选)用来筛选的表达式
示例
查找每个段落的父元素
HTML 代码:
jQuery 代码:
$("p").parent()
结果:
查找段落的父元素中每个类名为selected的父元素。
HTML 代码:
jQuery 代码:
$("p").parent(".selected")
结果:
----------------------------------------------------------------------------------------------------------------
parents([expr])
取得一个包含着所有匹配元素的祖先元素的元素集合(不包含根元素)。可以通过一个可选的表达式进行筛选。
Get a set of elements containing the unique ancestors of the matched set of elements (except for the root element). The matched elements can be filtered with an optional expression.
返回值
jQuery
参数
expr (String) : (可选) 用于筛选祖先元素的表达式
示例
找到每个span元素的所有祖先元素。
HTML 代码:
jQuery 代码:
$("span").parents()
找到每个span的所有是p元素的祖先元素。
jQuery 代码:
$("span").parents("p")
----------------------------------------------------------------------------------------------------------------
prev([expr])
取得一个包含匹配的元素集合中每一个元素紧邻的前一个同辈元素的元素集合。
可以用一个可选的表达式进行筛选。只有紧邻的同辈元素会被匹配到,而不是前面所有的同辈元素。
Get a set of elements containing the unique previous siblings of each of the matched set of elements.
Use an optional expression to filter the matched set. Only the immediately previous sibling is returned, not all previous siblings.
返回值
jQuery
参数
expr (String) : (可选) 用于筛选前一个同辈元素的表达式
示例
找到每个段落紧邻的前一个同辈元素。
HTML 代码:
Hello
Hello Again
And Again
jQuery 代码:
$("p").prev()
结果:
找到每个段落紧邻的前一个同辈元素中类名为selected的元素。
HTML 代码:
Hello
Hello Again
And Again
jQuery 代码:
$("p").prev(".selected")
结果:
----------------------------------------------------------------------------------------------------------------
prevAll([expr])
查找当前元素之前所有的同辈元素
可以用表达式过滤。
Find all sibling elements before the current element.
Use an optional expression to filter the matched set.
返回值
jQuery
参数
expr (String) : (可选) 用于过滤的表达式
示例
给最后一个之前的所有div加上一个类
HTML 代码:
jQuery 代码:
$("div:last").prevAll().addClass("before");
结果:
----------------------------------------------------------------------------------------------------------------
siblings([expr])
取得一个包含匹配的元素集合中每一个元素的所有唯一同辈元素的元素集合。可以用可选的表达式进行筛选。
Get a set of elements containing all of the unique siblings of each of the matched set of elements. Can be filtered with an optional expressions.
返回值
jQuery
参数
expr (String) : (可选) 用于筛选同辈元素的表达式
示例
找到每个div的所有同辈元素。
HTML 代码:
Hello
Hello Again
And Again
jQuery 代码:
$("div").siblings()
结果:
Find elements with class name selected among all sibling elements of each div.
HTML code:
Hello
Hello Again
And Again
jQuery code:
$("p").siblings(".selected")
Result:
[
Hello Again
]
-------------------------- -------------------------------------------------- --------------------------------------------------
andSelf()
Add the previously selected element to the current element
It will be useful when you want to add previously selected elements to filtered or searched elements.
Add the previous selection to the current selection.
Useful for traversing elements, and then adding something that was matched before the last traversion.
Return value
jQuery
Example
Select all divs and internal p, and add border class
HTML code:
First Paragraph
Second Paragraph
jQuery code:
$("div").find("p").andSelf().addClass("border");
Result:
First Paragraph
Second Paragraph
-------------------------------------------------- -------------------------------------------------- --------------------------
end()
Go back to the last "destructive" operation. That is, change the matching element list to the previous state.
If there are no previous destructive operations, return an empty set. The so-called "destructive" refers to any operation that changes the matched jQuery element. This includes any function in Traversing that returns a jQuery object - 'add', 'andSelf', 'children', 'filter', 'find', 'map', 'next', 'nextAll', 'not', 'parent', 'parents', 'prev', 'prevAll', 'siblings' and 'slice' - plus 'clone' in Manipulation.
Revert the most recent 'destructive' operation, changing the set of matched elements to its previous state (right before the destructive operation).
If there was no destructive operation before, an empty set is returned. A 'destructive' operation is any operation that changes the set of matched jQuery elements, which means any Traversing function that returns a jQuery object - including 'add', 'andSelf', 'children', 'filter', 'find', 'map', 'next', 'nextAll', 'not', 'parent', 'parents', 'prev', 'prevAll', 'siblings ' and slice - plus the 'clone' function (from Manipulation).
Return value
jQuery
Example
Select all p elements, find and select span sub-elements, and then go back and select p elements
HTML code:
jQuery code:
$("p").find("span").end()
Result: