返回值:jQuery add(expr|ele|html|obj [,con] )
概述
把與表達式匹配的元素新增到jQuery對像中。這個函式可以用於連線分別與兩個表達式匹配的元素結果集。
jQuery 1.4 中, .add()方法返回的結果將始終以元素在HTML文件中出現的順序來排序,而不再是簡單的新增。
jQuery 1.9 中, .add()方法返回的結果總是按照節點在document(文件)中的順序排列。在1.9之前,如果上下文或輸入的集合中任何一個以脫離文件的節點(未在文件中)開始,使用.add()方法節點不會按照document(文件)中的順序排序。現在,返回的節點按照文件中的順序排序,並且脫離文件的節點被放置在集合的末尾。
參數
expr String V1.0
一個用於匹配元素的選擇器字串。
elements DOMElement V1.0
DOM元素。
html String V1.0
HTML片段新增到匹配的元素。
jQuery object object V1.3.2
一個jqeruy對像增加到匹配的元素
expr,context Element, jQuery V1.4
expr :用於匹配元素並新增的表達式字串,或者用於動態產生的HTML程式碼,如果是一個字串陣列則返回多個元素
context :作為待查詢的 DOM 元素集、文件或 jQuery 對象。
示例
描述:
新增一個新元素到一組匹配的元素中,並且這個新元素能匹配給定的表達式。
HTML 程式碼:
<p>Hello</p><span>Hello Again</span>
jQuery 程式碼:
$("p").add("span")
結果:
[ <p>Hello</p>, <span>Hello Again</span> ]
描述:
動態產生一個元素並新增至匹配的元素中
HTML 程式碼:
<p>Hello</p>
jQuery 程式碼:
$("p").add("<span>Again</span>")
結果:
[ <p>Hello</p>, <span>Hello Again</span> ]
描述:
為匹配的元素新增一個或者多個元素
HTML 程式碼:
<p>Hello</p><p><span id="a">Hello Again</span></p>
jQuery 程式碼:
$("p").add(document.getElementById("a"))
結果:
[ <p>Hello</p>, <p><span id="a">Hello Again</span></p>, <span id="a">Hello Again</span> ]