add(e|e|h|o[,c]) | jQuery API 3.2 中文文档 | jQuery API 在线手册

jQuery API 3.2.1

推荐办理招商信用卡,新户首刷礼,五折享美食,需要的速度围观~click here
首页  >  筛选  > add(e|e|h|o[,c]) 源码下载

返回值:jQueryadd(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> ]