- /**
- * 向每個匹配的元素內部追加內容。
- * 這個操作與對指定的元素執行 appendChild 方法,將它們添加到文檔中的情況類似。
- *
- * @content(String, Element, jQuery) 要追加到目標中的內容
- * @return Object
- * @owner jQuery Object
- */
- function append(content);
- // 例子:向所有段落中追加一些HTML標記。
- <p>I would like to say: </p>
- $("p").append("<b>Hello</b>") -> [ <p>I would like to say: <b>Hello</b></p> ]
● appendTo(content)
- /**
- * 把所有匹配的元素追加到另一個、指定的元素元素集合中。
- * 實際上,使用這個方法是顛倒了常規的 $(A).append(B) 的操作,即不是把 B 追加到 A 中,而是把 A
- * 追加到 B 中。
- *
- * @content(String) 用於被追加的內容
- * @return Object
- * @owner jQuery Object
- */
- function appendTo(content);
- // 例子:把所有段落追加到 ID 值爲 "foo" 的元素中。
- <p>I would like to say: </p>
- <div id="foo"></div>
- $("p").appendTo("#foo") -> <div id="foo"><p>I would like to say: </p></div>
● prepend(content)
- /**
- * 向每個匹配的元素內部前置內容。這是向所有匹配元素內部的開始處插入內容的最佳方式。
- *
- * @content(String, Element, jQuery) 要插入到目標元素內部前端的內容
- * @return Object
- * @owner jQuery Object
- */
- function prepend(content);
- // 例子一:向所有段落中前置一些 HTML 標記代碼。
- <p>I would like to say: </p>
- $("p").prepend("<b>Hello</b>") -> [ <p><b>Hello</b>I would like to say: </p> ]
- // 例子二:將一個 DOM 元素前置入所有段落
- <p>I would like to say: </p>
- <p>I would like to say: </p>
- <b class="foo">Hello</b>
- <b class="foo">Good Bye</b>
- $("p").prepend( $(".foo")[0] ) ->
- <p><b class="foo">Hello</b>I would like to say: </p>
- <p><b class="foo">Hello</b>I would like to say: </p>
- <b class="foo">Hello</b>
- <b class="foo">Good Bye</b>
- // 例子三:向所有段落中前置一個 jQuery 對象(類似於一個 DOM 元素數組)。
- <p>I would like to say: </p><b>Hello</b>
- $("p").prepend( $("b") ) -> <p><b>Hello</b>I would like to say: </p>
● prependTo(content)
- /**
- * 把所有匹配的元素前置到另一個、指定的元素元素集合中。
- * 實際上,使用這個方法是顛倒了常規的 $(A).prepend(B) 的操作,即不是把 B 前置到 A 中,而是把
- * A 前置到 B 中。
- *
- * @content(String) 用於匹配元素的 jQuery 表達式
- * @return Object
- * @owner jQuery Object
- */
- function prependTo(content);
- // 例子一:把所有段落追加到 ID 值爲 foo 的元素中。
- <p>I would like to say: </p>
- <div id="foo"></div>
- $("p").prependTo("#foo") -> <div id="foo"><p>I would like to say: </p></div>
● after(content)
- /**
- * 在每個匹配的元素之後插入內容。
- *
- * @content(String, Element, jQuery) 插入到每個目標後的內容
- * @return Object
- * @owner jQuery Object
- */
- function after(content);
- // 例子一:在所有段落之後插入一些 HTML 標記代碼。
- <p>I would like to say: </p>
- $("p").after("<b>Hello</b>") -> <p>I would like to say: </p><b>Hello</b>
- // 例子二:在所有段落之後插入一個 DOM 元素。
- <b id="foo">Hello</b><p>I would like to say: </p>
- $("p").after( $("#foo")[0] ) -> <p>I would like to say: </p><b id="foo">Hello</b>
- // 例子三:在所有段落中後插入一個 jQuery 對象(類似於一個DOM元素數組)。
- <b>Hello</b><p>I would like to say: </p>
- $("p").after( $("b") ) -> <p>I would like to say: </p><b>Hello</b>
● before(content)
- /**
- * 在每個匹配的元素之前插入內容。
- *
- * @content(String, Element, jQuery) 插入到每個目標前的內容
- * @return Object
- * @owner jQuery Object
- */
- function before(content);
- // 例子一:在所有段落之前插入一些 HTML 標記代碼。
- <p>I would like to say: </p>
- $("p").before("<b>Hello</b>") -> [ <b>Hello</b><p>I would like to say: </p> ]
- // 例子二:在所有段落之前插入一個元素。
- <p>I would like to say: </p>
- <b id="foo">Hello</b>
- $("p").before( $("#foo")[0] ) -> <b id="foo">Hello</b><p>I would like to say: </p>
- // 例子三:在所有段落中前插入一個 jQuery 對象(類似於一個DOM元素數組)。
- <p>I would like to say: </p><b>Hello</b>
- $("p").before( $("b") ) -> <b>Hello</b><p>I would like to say: </p>
● insertAfter(content)
- /**
- * 把所有匹配的元素插入到另一個,指定的元素元素集合的後面。
- * 實際上,使用這個方法是顛倒了常規的 $(A).after(B) 的操作,即不是把 B 插入到 A 後面,而是把 A
- * 插入到 B 後面。
- *
- * @content(String) 用於匹配元素的 jQuery 表達式
- * @return Object
- * @owner jQuery Object
- */
- function insertAfter(content);
- // 例子一:把所有段落插入到一個元素之後。與 $("#foo").after("p") 相同。
- <p>I would like to say: </p>
- <div id="foo">Hello</div>
- $("p").insertAfter("#foo") -> <div id="foo">Hello</div><p>I would like to say: </p>
● insertBefore(content)
- /**
- * 把所有匹配的元素插入到另一個、指定的元素元素集合的前面。
- * 實際上,使用這個方法是顛倒了常規的 $(A).before(B) 的操作,即不是把 B 插入到 A 前面,而是把 A
- * 插入到 B 前面。
- *
- * @content(String) 用於匹配元素的 jQuery 表達式
- * @return Object
- * @owner jQuery Object
- */
- function insertBefore(content);
- // 例子:把所有段落插入到一個元素之前。與 $("#foo").before("p") 相同。
- <div id="foo">Hello</div>
- <p>I would like to say: </p>
- $("p").insertBefore("#foo") -> <p>I would like to say: </p><div id="foo">Hello</div>
● wrap(elem)
- /**
- * 把所有匹配的元素用其他元素的結構化標記包裝起來。
- *
- * @elem(Element) 用於包裝目標元素的 DOM 元素
- * @return Object
- * @owner jQuery Object
- */
- function wrap(elem);
- // 例子:用 ID 是 "content" 的 div 將每一個段落包裹起來。
- <p>Test Paragraph.</p>
- <div id="content"></div>
- $("p").wrap(document.getElementById('content')) ->
- <div id="content"><p>Test Paragraph.</p></div><div id="content"></div>
● wrapAll(elem)
- /**
- * 將所有匹配的元素用單個元素包裹起來。這於 wrap(elem) 是不同的,wrap(elem) 爲每一個匹配的元素都
- * 包裹一次。
- *
- * @elem(Element) 用於包裝目標元素的 DOM 元素
- * @return Object
- * @owner jQuery Object
- */
- function wrapAll(elem);
- // 例子:用一個生成的 div 將所有段落包裹起來。
- <p>Hello</p>
- <p>cruel</p>
- <p>World</p>
- $("p").wrapAll(document.createElement("div")) -> <div><p>Hello</p><p>cruel</p><p>World</p></div>
● wrapInner(elem)
- /**
- * 將每一個匹配的元素的子內容(包括文本節點)用 DOM 元素包裹起來。
- *
- * @elem(Element) 用於包裝目標元素的 DOM 元素
- * @return Object
- * @owner jQuery Object
- */
- function wrapInner(elem);
- // 例子:把所有段落內的每個子內容加粗。
- <p>Hello</p>
- <p>cruel</p>
- <p>World</p>
- $("p").wrapInner(document.createElement("b")) ->
- <p><b>Hello</b></p><p><b>cruel</b></p><p><b>World</b></p>
● wrap(html)
- /**
- * 把所有匹配的元素用其他元素的結構化標記包裹起來。
- * 這種包裝對於在文檔中插入額外的結構化標記最有用,而且它不會破壞原始文檔的語義品質。
- *
- * 這個函數的原理是檢查提供的 html(它是由所提供的 HTML 標記代碼動態生成的),並在它的代碼結構中
- * 找到最上層的祖先元素 - 這個祖先元素就是包裹元素。
- *
- * 當 HTML 標記代碼中的元素包含文本時無法使用這個函數。因此,如果要添加文本應該在包裹完成之後再行添加。
- *
- * @html(String) HTML 標記代碼字符串,用於動態生成元素幷包裹目標元素
- * @return Object
- * @owner jQuery Object
- */
- function wrap(html);
- // 例子:把所有的段落用一個新創建的 div 包裹起來。
- <p>Test Paragraph.</p>
- $("p").wrap("<div class='wrap'></div>") -> <div class="wrap"><p>Test Paragraph.</p></div>
● wrapAll(html)
- /**
- * 將所有匹配的元素用單個元素包裹起來。這於 wrap(html)是不同的,wrap(html) 爲每一個匹配的元素都
- * 包裹一次。
- *
- * 這種包裝對於在文檔中插入額外的結構化標記最有用,而且它不會破壞原始文檔的語義品質。
- *
- * 這個函數的原理是檢查提供的第一個元素並在它的代碼結構中找到最上層的祖先元素 - 這個祖先元素就
- * 是包裝元素。
- *
- * @html(String) HTML 標記代碼字符串,用於動態生成元素幷包裝目標元素
- * @return Object
- * @owner jQuery Object
- */
- function wrapAll(html);
- // 例子:用一個生成的 div 將所有段落包裹起來。
- <p>Hello</p>
- <p>cruel</p>
- <p>World</p>
- $("p").wrapAll("<div></div>") -> <div><p>Hello</p><p>cruel</p><p>World</p></div>
● wrapInner(html)
- /**
- * 將每一個匹配的元素的子內容(包括文本節點)用一個 HTML 結構包裹起來。
- *
- * 這個函數的原理是檢查提供的第一個元素(它是由所提供的 HTML 標記代碼動態生成的),並在它的代碼結構中
- * 找到最上層的祖先元素 - 這個祖先元素就是包裝元素。
- *
- * @html(String) HTML 標記代碼字符串,用於動態生成元素幷包裝目標元素
- * @return Object
- * @owner jQuery Object
- */
- function wrapInner(html);
- // 例子:把所有段落內的每個子內容加粗。
- <p>Hello</p>
- <p>cruel</p>
- <p>World</p>
- $("p").wrapInner("<b></b>") -> <p><b>Hello</b></p><p><b>cruel</b></p><p><b>World</b></p>
● replaceAll(selector)
- /**
- * 用匹配的元素替換掉所有 selector 匹配到的元素。
- *
- * @selector(Selector) 用於查找所要被替換的元素
- * @return Object
- * @owner jQuery Object
- */
- function replaceAll(selector);
- // 例子:把所有的段落標記替換成加粗標記。
- <p>Hello</p>
- <p>cruel</p>
- <p>World</p>
- $("<b>Paragraph. </b>").replaceAll("p") ->
- <b>Paragraph. </b><b>Paragraph. </b><b>Paragraph. </b>
● replaceWith(content)
- /**
- * 將所有匹配的元素替換成指定的 HTML 或 DOM 元素。
- *
- * @content(String, Element, jQuery) 用於將匹配元素替換掉的內容
- * @return Object
- * @owner jQuery Object
- */
- function replaceWith(content);
- // 例子:把所有的段落標記替換成加粗的標記。
- <p>Hello</p>
- <p>cruel</p>
- <p>World</p>
- $("p").replaceWith("<b>Paragraph. </b>") ->
- <b>Paragraph. </b><b>Paragraph. </b><b>Paragraph. </b>
● empty()
- /**
- * 刪除匹配的元素集合中所有的子節點。
- *
- * @return Object
- * @owner jQuery Object
- */
- function empty();
- // 例子:把所有段落的子元素(包括文本節點)刪除。
- <p>Hello, <span>Person</span> <a href="#">and person</a></p>
- $("p").empty() -> <p></p>
● remove([expr])
- /**
- * 從 DOM 中刪除所有匹配的元素。這個方法不會把匹配的元素從 jQuery 對象中刪除,因而可以在將來再使用
- * 這些匹配的元素。
- *
- * @expr(String) (可選) 用於篩選元素的 jQuery 表達式
- * @return Object
- * @owner jQuery Object
- */
- function remove([expr]);
- // 例子一:從 DOM 中把所有段落刪除。
- <p>Hello</p> how are <p>you?</p>
- $("p").remove() -> how are
- // 例子二:從 DOM 中把帶有 hello 類的段落刪除。
- <p class="hello">Hello</p> how are <p>you?</p>
- $("p").remove(".hello") -> how are <p>you?</p>
● clone()
- /**
- * 克隆匹配的 DOM 元素並且選中這些克隆的副本。
- * 在想把 DOM 文檔中元素的副本添加到其他位置時這個函數非常有用。
- *
- * @return Object
- * @owner jQuery Object
- */
- function clone();
- // 例子:克隆所有 b 元素(並選中這些克隆的副本),然後將它們前置到所有段落中。
- <b>Hello</b><p>, how are you?</p>
- $("b").clone().prependTo("p") -> <b>Hello</b><p><b>Hello</b>, how are you?</p>
● clone(true)
- /**
- * 元素以及其所有的事件處理並且選中這些克隆的副本。
- * 在想把 DOM 文檔中元素的副本添加到其他位置時這個函數非常有用。
- *
- * @true(Boolean) 設置爲 true 以便複製元素的所有事件處理
- * @return Object
- * @owner jQuery Object
- */
- function clone(true);
- // 例子:創建一個按鈕,它可以複製自己,並且它的副本也有同樣功能。
- <button>Clone Me!</button>
- $("button").click(function() {
- $(this).clone(true).insertAfter(this);
- });