返回值:jQueryadd(expr|ele|html|obj[,con])
jQuery add() 方法概述
把與表達(dá)式匹配的元素添加到j(luò)Query對(duì)象中。這個(gè)函數(shù)可以用于連接分別與兩個(gè)表達(dá)式匹配的元素結(jié)果集。
jQuery 1.4 中, .add()方法返回的結(jié)果將始終以元素在HTML文檔中出現(xiàn)的順序來(lái)排序,而不再是簡(jiǎn)單的添加。
jQuery 1.9 中, .add()方法返回的結(jié)果總是按照節(jié)點(diǎn)在document(文檔)中的順序排列。在1.9之前,如果上下文或輸入的集合中任何一個(gè)以脫離文檔的節(jié)點(diǎn)(未在文檔中)開(kāi)始,使用.add()方法節(jié)點(diǎn)不會(huì)按照document(文檔)中的順序排序?,F(xiàn)在,返回的節(jié)點(diǎn)按照文檔中的順序排序,并且脫離文檔的節(jié)點(diǎn)被放置在集合的末尾。
參數(shù)
exprStringV1.0
一個(gè)用于匹配元素的選擇器字符串。
elementsDOMElementV1.0
DOM元素。
htmlStringV1.0
HTML片段添加到匹配的元素。
jQuery objectobjectV1.3.2
一個(gè)jqeruy對(duì)象增加到匹配的元素
expr,contextElement, jQueryV1.4
expr:用于匹配元素并添加的表達(dá)式字符串,或者用于動(dòng)態(tài)生成的HTML代碼,如果是一個(gè)字符串?dāng)?shù)組則返回多個(gè)元素
context:作為待查找的 DOM 元素集、文檔或 jQuery 對(duì)象。
示例
描述:
添加一個(gè)新元素到一組匹配的元素中,并且這個(gè)新元素能匹配給定的表達(dá)式。
HTML 代碼:
<p>Hello</p><span>Hello Again</span>
jQuery 代碼:
$("p").add("span")
結(jié)果:
[ <p>Hello</p>, <span>Hello Again</span> ]
描述:
動(dòng)態(tài)生成一個(gè)元素并添加至匹配的元素中
HTML 代碼:
<p>Hello</p>
jQuery 代碼:
$("p").add("<span>Again</span>")
結(jié)果:
[ <p>Hello</p>, <span>Hello Again</span> ]
描述:
為匹配的元素添加一個(gè)或者多個(gè)元素
HTML 代碼:
<p>Hello</p><p><span id="a">Hello Again</span></p>
jQuery 代碼:
$("p").add(document.getElementById("a"))
結(jié)果:
[ <p>Hello</p>, <p><span id="a">Hello Again</span></p>, <span id="a">Hello Again</span> ]