包装集的大小及元素获取
语法:size()
功能:返回包装集里元素的个数。
语法:get([index])
功能:获取包装集里的一个或所有匹配元素。
参数 index:如果不指定参数,包装集里的所有元素就以JavaScript数组形式返回;如果指定了下标参数,就返回下标所对应的元素。
返回:DOM元素或DOM元素数组。
语法:index(element)
功能:在包装集中查找传入的元素。并返回该元素在包装集的顺序下标;如果不存在该元素,则返回-1。
参数 element:元素的引用,用于确定元素的下标。
返回:元素在包装集的顺序下标;如果不存在该元素,则返回-1。
筛选元素包装集
语法:add(expression)
功能:把表达式参数所指定的元素添加到包装集。
参数 expression:指定添加到包装集的元素。
- 参数为jQuery选择器:全部匹配元素都被添加到集合。
- 参数为HTML片断:创建适当的元素并添加到集合。
- 参数为DOM元素或DOM元素数组:直接添加到集合。
返回:包装集。
语法:not(expression)
功能:根据表达式参数的值,从包装集里删除元素。
参数 expresssion:定义从包装集里删除的元素。
- 参数为jQuery选择器:从包装集里删除任何匹配表达式的元素。
- 参数为元素引用或元素引用数组:从包装集里删除该元素。
返回:包装集。
语法:filter(expression)
功能:利用传入的选择器表达式或筛选函数,从包装集里筛选元素。
参数 expression:要进行元素筛选的表达式。
- 参数为字符串,则指定jQuery选择器,用于从包装集里删除所有与选择器不匹配的元素。
- 参数为一个函数,则用于确定筛选条件。为包装集里的每一个元素各调用一次该函数,以当前元素作为当次调用的函数上下文(this)。函数调用返回值为 false的任何元素都会从包装集里删除。
返回:包装集。
语法:slice(begin, end)
功能:创建并返回新包装集,新包装集包含原始包装的连续的一部分。
参数 begin:将被包含在返回切片中的第一个元素的下标(元素下标从0开始)。
参数 end:不包含在返回切片中的第一个元素的下标(从0开始);或一个数字,该数字超出了原始包装集的最后一个元素的下标。如果省略,则切片延伸到原始包装集的末尾。
返回:新建的包装集。
方法 | 描述 |
children() | 返回原始包装集元素的所有唯一子元素所组成的包装集。 |
contents() | 返回原始包装集元素的内容的包装集,这些元素可能包含文本节点(这个方法经常用于获取<iframe>元素的内容)。 |
next() | 返回原始包装集的所有唯一的下一个兄弟元素所组成的包装集。 |
nextAll() | 返回包含原始包装集元素的所有后续兄弟元素的包装集。 |
parent() | 返回原始包装集所有元素的唯一直接父元素所组成的包装集。 |
parents() | 返回原始包装集所有元素的唯一祖先元素所组成的包装集,包括直接父元素和一直向上追溯的祖先元素,但不包括文档根元素。 |
prev() | 返回原始包装集元素元素的所有唯一的上一个兄弟元素所组成的包装集。 |
prevAll() | 返回包含原始包装集元素的所有前面兄弟元素的包装集。 |
siblings() | 返回原始包装集元素的所有唯一兄弟元素所组成的包装集。 |
语法:find(selector)
功能:返回新包装集,包含原始包装集里与传入选择器表达式相匹配的所有元素。注意:原始包装集里的元素的后代,会因为与传入的选择器表达式相匹配而被包含在新包装集里。
参数 selector:一个jQuery选择器,元素必须匹配这个选择器,才能成为新包装集的一部分。
返回:新建的包装集。
语法:containers(text)
功能:返回新包装集,由包含text参数所传入的文本字符串的元素所组成。
参数 text:添加到新包装集里的元素必须包含的文本。
返回:新建的包装集。
语法:is(selector)
功能:确定包装集里是否有元素匹配元素选择器表达式。
参数 selector:选择器表达式,用于测试包装集的元素。
返回:如果至少有一个元素匹配传入的选择器,则返回 true,否则返回 false。
语法:end()
功能:在jQuery命令链入调用,以便回退到前一个包装集。
返回:前一个包装集。
语法:andSelf()
功能:合并命令链入最近产生的两个包装集。
返回:合并后的包装集。