JQuery中.add()的API应用

1.add()

描述:添加元素到匹配的元素集合。
.add( selector )
  • selector
    类型: [Selector]:一个字符串表示的选择器表达式,找到更多的元素添加到匹配的元素集合。
.add( elements )
  • elements
    类型: [Elements]:一个或多个元素添加到匹配的元素集合。
.add(html)
  • html
    类型: [HTML]:HTML片段添加到匹配的元素集合。
.add(jQuery object)
  • jQuery object
    类型: [jQuery object]:一个现有的jQuery对象添加到匹配的元素集合。
.add(selector,context)
  • selector
    类型: [Selector]:一个字符串表示的选择器表达式,找到更多的元素添加到匹配的元素集合。
  • context
    类型: [Element]: 指定选择器查找元素所在的上下文; 类似$(selector, context)方法的context(上下文)参数。

鉴于一个jQuery对象,表示一个DOM元素的集合,.add()方法通过传递这些元素组合到该方法构造一个新的jQuery对象。.add()的参数可以几乎接受任何的$(),包括一个jQuery选择器表达式,DOM元素,或HTML片段引用。

不要假设此方法会按照传递给.add()方法的参数的顺序添加到已经存在的集合中。如果所有元素都属于同一个文档,.add()方法所返回的集合将会按照元素在文档中出现的位置进行排序;也就是说,按照每个元素在文档中出现的顺序。如果集合中包含不同文档或不属于任何文档的元素,最后的排序方式未定义(undefined)。为了创建一个包含已定义顺序顺序的jQuery对象,请使用$(array_of_DOM_elements)

他更新的元素集合,可以使用以下面的链式调用,或分配给一个变量供以后使用。例如:

$("p").add("div").addClass("widget");
var pdiv = $("p").add("div");

下面将不会保存添加的元素,因为在.add()方法创建一个新集合,并保持原集合PDIV不变:

var pdiv = $("p");
pdiv.add("div");  // WRONG, pdiv will not change

考虑一个面页中简单的列表和它之后的段落:

<ul>
 <li>list item 1</li>
 <li>list item 2</li>
 <li>list item 3</li>
</ul>
<p>a paragraph</p>

我们可以选择列表,然后通过使用一个选择器或引用的DOM元素本身作为.add()方法的参数,将段落添加到列表中:

$('li').add('p').css('background-color', 'red');

或者:

$('li').add(document.getElementsByTagName('p')[0])
.css('background-color', 'red');

该调用的结果是四个元素的红色背景。使用片一个HTML段作为 .add()方法的参数(如在第三个版本),我们可以在动态的创建额外的元素,添加这些元素到匹配的元素集合中。例如,我们可以改变新创建的段落和列表项的背景:

$('li').add('<p id="new">new paragraph</p>')
.css('background-color', 'red');

虽然已经创建新的段落,并且改变其背景颜色,但是它仍然没有出现在页面上。要想在页面上显示该段落,我们需要在链式方式中使用 jQuery 的插入方法。

在jQuery 1.4结果从.add()将总是返回文档顺序(而不是一个简单的串联)。

注意: 要使用.add()相反的方法, 您可以使用.not( elements | selector )从jQuery返回中移除元素, 或使用.end()返回到添加之前的选择(集合)。

例子:

Example: 查找所有的 div,并且添加一个边框。然后将所有的段落添加到 jQuery 对象中,并将它们的背景色变成黄色。

<!DOCTYPE html>
<html>
<head>
  <style>
div { width:60px; height:60px; margin:10px; float:left; }

 p { clear:left; font-weight:bold; font-size:16px;

 color:blue; margin:0 10px; padding:2px; }

 </style>

 <script src="https://code.jquery.com/jquery-latest.js"></script>

</head>

<body>

 <div></div>

 <div></div>

 <div></div>

 <div></div>
 <div></div>

 <div></div>

 <p>Added this... (notice no border)</p>

<script>

$("div").css("border", "2px solid red")

 .add("p")

 .css("background", "yellow");

</script>

</body>

</html>

Demo:

image.png

Example: 根据给定的表达式,向匹配的元素集合中添加一些元素。

<!DOCTYPE html>

<html>

<head>

 <script src="https://code.jquery.com/jquery-latest.js"></script>

</head>

<body>

 <p>Hello</p><span>Hello Again</span>

<script>$("p").add("span").css("background", "yellow");</script>

</body>

</html>

Demo:

image.png

Example: 动态的向匹配的元素集合中添加一些元素。


<!DOCTYPE html>

<html>

<head>

 <script src="https://code.jquery.com/jquery-latest.js"></script>

</head>

<body>

 <p>Hello</p>

<script>$("p").clone().add("<span>Again</span>").appendTo(document.body);</script>

</body>

</html>

Demo:

image.png

Example: 向匹配的元素集合中添加一些元素对象。

<!DOCTYPE html>

<html>

<head>

 <script src="https://code.jquery.com/jquery-latest.js"></script>

</head>

<body>

 <p>Hello</p><span id="a">Hello Again</span>

<script>$("p").add(document.getElementById("a")).css("background", "yellow");</script>

</body>

</html>

Demo:

image.png

Example: 以下示例展示了如何向一个已经存在的集合中添加元素。

<!DOCTYPE html>

<html>

<head>

 <script src="https://code.jquery.com/jquery-latest.js"></script>

</head>

<body>

 <p>Hello</p><span id="a">Hello Again</span>

<script>var collection = $("p");

// capture the new collection

collection = collection.add(document.getElementById("a"));

collection.css("background", "yellow");</script>

</body>

</html>

Demo:

image.png
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 222,252评论 6 516
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 94,886评论 3 399
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 168,814评论 0 361
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 59,869评论 1 299
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 68,888评论 6 398
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 52,475评论 1 312
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 41,010评论 3 422
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 39,924评论 0 277
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 46,469评论 1 319
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 38,552评论 3 342
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 40,680评论 1 353
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 36,362评论 5 351
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 42,037评论 3 335
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 32,519评论 0 25
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 33,621评论 1 274
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 49,099评论 3 378
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 45,691评论 2 361

推荐阅读更多精彩内容

  • 问题本身并不复杂,可人的大脑却复杂的很,它有想象力,有经验判断,会夹杂自己的感情,会因为感情的深度、关系的复杂度,...
    Air糖阅读 345评论 0 0
  • 里仁22 子曰:“古者言之不出,耻躬之不逮也。” 夫子说:古代人不随便说话,以自己做不到为耻辱。
    陈尚军阅读 248评论 0 1
  • 我已经叫复活节兔子给你捎个“蛋”,希望它到达时不会看到你已经慵懒而死了! 我喜欢扉页上有题签、页边写满注记的旧书;...
    楠说阅读 978评论 0 0
  • 本Git系列内容更多是基于廖雪峰老师的Git教程的个人笔记、总结和扩展,如有错误,请多多指正。 在版本操作中我们已...
    孤宆阅读 252评论 0 0