add(e|e|h|o[,c])

返回值

jQuery

概述

把与表达式匹配的元素添加到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> ]