NodeList

节点集合类。

NodeList ( nodes )

参数：

nodesArray<Element>|ArrayLike<Element>
节点数组或类数组。

get ( [i=0] )

返回指定索引的节点。

参数：

[i=0]Number
索引。如果为负数，则从末尾倒数。

返回值：

Element指定节点。

eq ( [i=0] )

返回仅包含指定索引节点的NodeList对象。

参数：

[i=0]Number
索引。如果为负数，则从末尾倒数。

返回值：

NodeListNodeList对象。

first ( )

获取仅包含当前集合第一个节点的NodeList对象。

返回值：

NodeListNodeList对象。

last ( )

获取仅包含当前集合最后一个节点的NodeList对象。

返回值：

NodeListNodeList对象。

toArray ( )

把当前集合转换为数组。

返回值：

Array转换结果。

find ( selector )

以当前集合为上下文，根据选择器匹配节点。

参数：

selectorString
选择器。

返回值：

NodeList由匹配到的节点组成的NodeList对象。

filter ( selector )

从当前集合中过滤出符合指定规则的节点。

参数：

selectorString|Function
选择器或过滤函数。

返回值：

NodeList由过滤出的节点组成的NodeList对象。

add ( )

返回包含当前节点及匹配到的新节点的集合（无重复节点），参数同$函数。

返回值：

NodeList包含当前节点和新节点的集合。

uniqueSort ( )

对当前集合进行唯一性筛选并排序。

返回值：

NodeList当前集合。

each ( callback )

对当前集合中的每个节点执行指定函数。

参数：

callbackFunction
操作函数。如果函数返回false，遍历中止。

返回值：

NodeList当前集合。

slice ( begin , [end] )

返回由当前集合中指定区间的节点组成的新集合。

参数：

beginNumber
开始位置。
[end]Number
结束位置（不包含）。

返回值：

NodeList新集合。

indexOf ( node , [fromIndex=0] )

在当前集合中搜索节点。

参数：

nodeElement
要搜索的节点。
[fromIndex=0]Number
搜索的开始位置。

返回值：

Number节点索引。

forEach ( callback , [thisArg] )

对当前集合中的每个节点执行指定函数。

参数：

callbackFunction
操作函数。
[thisArg]Any
操作函数中的this。

every ( callback , [thisArg] )

测试当前集合中的所有节点是否都符合指定规则。

参数：

callbackFunction
规则函数。
[thisArg]Any
规则函数中的this。

返回值：

Boolean测试结果。

some ( callback , [thisArg] )

测试当前集合中是否有节点符合指定规则。

参数：

callbackFunction
规则函数。
[thisArg]Any
规则函数中的this。

返回值：

Boolean测试结果。

map ( callback , [thisArg] )

通过映射关系创建一个新数组。

参数：

callbackFunction
映射函数。
[thisArg]Any
映射函数中的this。

返回值：

Array新数组。

pop ( )

移出当前集合的最后一个节点。

返回值：

Element被移出的节点。

shift ( )

移出当前集合的第一个节点。

返回值：

Element被移出的节点。

splice ( index , [howMany] , [element] )

从当前集合中移出或插入节点。

参数：

indexNumber
操作位置。
[howMany]Number
移出数量。如果不指定，则移出开始位置之后的所有节点。
[element]Element*
向集合插入的新节点。

返回值：

Array被移出的节点所组成的数组。

attr ( name ) +2

获取当前第一个节点的属性值。

参数：

nameString
属性名。

返回值：

String属性值。

attr ( name , value ) +2

设置当前所有节点的属性值。

参数：

nameString
属性名。
valueString
属性值。

返回值：

NodeList当前节点集合。

attr ( attrs ) +2

设置当前所有节点的属性值。

参数：

attrsObject
属性字典。

返回值：

NodeList当前节点集合。

removeAttr ( names )

移除当前所有节点的指定属性。

参数：

namesString|Array<String>
属性名。多个属性名用空格隔开，或者以数组传入。

返回值：

NodeList当前节点集合。

prop ( name ) +2

获取当前第一个节点的特性值。

参数：

nameString
特性名。

返回值：

Any特性值。

prop ( name , value ) +2

设置当前所有节点的特性值。

参数：

nameString
特性名。
valueAny
特性值。

返回值：

NodeList当前节点集合。

prop ( props ) +2

设置当前所有节点的特性值。

参数：

propsObject
特性字典。

返回值：

NodeList当前节点集合。

removeProp ( names )

移除当前所有节点的指定特性。

参数：

namesString|Array<String>
特性名。多个特性名用空格隔开，或者以数组传入。

返回值：

NodeList当前节点集合。

text ( ) +1

获取当前第一个节点的文本内容。

返回值：

String文本内容。

text ( content ) +1

设置当前所有节点的文本内容。

参数：

contentString|Function
文本内容。

返回值：

NodeList当前节点集合。

html ( ) +1

获取当前第一个节点的innerHTML。

返回值：

StringinnerHTML。

html ( ) +1

设置当前所有节点的innerHTML。

参数：

String|Function
innerHTML

返回值：

NodeList当前节点集合。

val ( ) +1

获取当前第一个节点的value属性值。

返回值：

Stringvalue属性值。

val ( val ) +1

设置当前所有节点的value属性值。

参数：

valString|Function
value属性值。

返回值：

NodeList当前节点集合。

data ( key ) +2

获取当前第一个节点的数据。

参数：

keyString
数据名。

返回值：

Any数据值。

data ( key , value ) +2

设置当前所有节点的数据。

参数：

keyString
数据名。
valueAny
数据值。

返回值：

NodeList当前节点集合。

data ( data ) +2

设置当前所有节点的数据。

参数：

dataObject
数据字典。

返回值：

NodeList当前节点集合。

removeData ( [keys] )

移除当前所有节点的数据。

参数：

[keys]String|Array<String>
数据名。如果为空，则移除所有自定义数据； 多个数据名用空格隔开，或者以数组传入。

返回值：

NodeList当前节点集合。

index ( ) +2

获取当前集合第一个节点在同级节点中的位置。

返回值：

Number节点位置。

index ( selector ) +2

获取当前集合第一个节点在指定选择器匹配的节点集合中的位置。

参数：

selectorString
选择器。

返回值：

Number节点位置。

index ( node ) +2

获取指定节点在当前集合中的位置。

参数：

nodeNodeList|Element|Array
指定节点。

返回值：

Number节点位置。

children ( [selector] )

获取当前所有节点的子节点。

参数：

[selector]String
过滤结果集的选择器。

返回值：

NodeList结果集。

next ( [selector] )

获取当前所有节点的后一个同级节点。

参数：

[selector]String
过滤结果集的选择器。

返回值：

NodeList结果集。

nextAll ( [selector] )

获取当前所有节点后的所有同级节点。

参数：

[selector]String
过滤结果集的选择器。

返回值：

NodeList结果集。

prev ( [selector] )

获取当前所有节点的前一个同级节点。

参数：

[selector]String
过滤结果集的选择器。

返回值：

NodeList结果集。

prevAll ( [selector] )

获取当前所有节点前的所有同级节点。

参数：

[selector]String
过滤结果集的选择器。

返回值：

NodeList结果集。

parent ( [selector] )

获取当前所有节点的父节点。

参数：

[selector]String
过滤结果集的选择器。

返回值：

NodeList结果集。

parents ( [selector] )

获取当前所有节点的所有祖先节点。

参数：

[selector]String
过滤结果集的选择器。

返回值：

NodeList结果集。

siblings ( [selector] )

获取当前所有节点的所有同级节点。

参数：

[selector]String
过滤结果集的选择器。

返回值：

NodeList结果集。

nextUntil ( until , [filter] )

获取当前节点之后的同级节点，直到遇到符合指定选择器规则的节点为止。

参数：

untilString|Element|Array<Element>
截止规则或节点。
[filter]String
过滤结果集的选择器。

返回值：

NodeList结果集。

prevUntil ( until , [filter] )

获取当前节点之前的同级节点，直到遇到符合指定选择器规则的节点为止

参数：

untilString|Element|Array<Element>
截止规则或节点
[filter]String
过滤结果集的选择器

返回值：

NodeList结果集

parentsUntil ( until , [filter] )

获取当前节点的祖先节点，直到遇到符合指定选择器规则的节点为止。

参数：

untilString|Element|Array<Element>
截止规则或节点。
[filter]String
过滤结果集的选择器。

返回值：

NodeList结果集。

append ( target )

在当前所有节点的最后一个子节点后插入目标节点（或其副本）。

参数：

targetString|Element|ArrayLike<Element>|DocumentFragment
目标节点。

返回值：

NodeList当前节点集合。

appendTo ( target )

在目标节点的最后一个子节点后插入当前所有节点（或其副本）。

参数：

targetString|Element|ArrayLike<Element>|DocumentFragment
目标节点

返回值：

NodeList包含被插入节点的节点集合。

prepend ( target )

在当前所有节点的第一个子节点前插入目标节点（或其副本）。

参数：

targetString|Element|ArrayLike<Element>|DocumentFragment
目标节点。

返回值：

NodeList当前节点集合。

prependTo ( target )

在目标节点的第一个子节点前插入当前所有节点（或其副本）。

参数：

targetString|Element|ArrayLike<Element>|DocumentFragment
目标节点。

返回值：

NodeList包含被插入节点的节点集合。

before ( target )

在当前所有节点之前插入目标节点（或其副本）。

参数：

targetString|Element|ArrayLike<Element>|DocumentFragment
目标节点。

返回值：

NodeList当前节点集合。

insertBefore ( target )

把当前节点插入到目标节点之前。

参数：

targetString|Element|ArrayLike<Element>|DocumentFragment
目标节点。

返回值：

NodeList包含被插入节点的节点集合。

after ( target )

在当前所有节点之后插入目标节点（或其副本）。

参数：

targetString|Element|ArrayLike<Element>|DocumentFragment
目标节点。

返回值：

NodeList当前节点集合。

insertAfter ( target )

把当前节点（或其副本）插入到目标节点之后。

参数：

targetString|Element|ArrayLike<Element>|DocumentFragment
目标节点。

返回值：

NodeList包含被插入节点的节点集合。

replaceWith ( target )

把当前节点替换为目标节点（或其副本）。

参数：

targetString|Element|ArrayLike<Element>|DocumentFragment
目标节点。

返回值：

NodeList当前节点集合。

replaceAll ( target )

把目标节点替换为当前节点（或其副本）。

参数：

targetString|Element|ArrayLike<Element>|DocumentFragment
目标节点。

返回值：

NodeList包含被 插入节点的节点集合。。

detach ( )

把当前所有节点从其所属文档中移除，但保留其数据。

返回值：

NodeList当前节点集合。

remove ( )

把当前所有节点从其所属文档中移除，并清除其数据。

返回值：

NodeList当前节点集合。

empty ( )

移除当前所有节点下的所有后代节点。

返回值：

NodeList当前节点集合。

css ( name ) +2

获取当前第一个节点的样式值。

参数：

nameString
样式名。

返回值：

String样式值。

css ( name , val ) +2

设置当前所有节点的样式值。

参数：

nameString
样式名。
valString|Number
样式值。

返回值：

NodeList当前节点集合。

css ( cssProps ) +2

设置当前所有节点的样式值。

参数：

cssPropsObject
样式字典。

返回值：

NodeList当前节点集合。

hasClass ( className )

检查当前节点集合中是否至少有一个节点包含指定样式类。

参数：

classNameString
样式类。

返回值：

Boolean是否有节点包含指定CSS样式类。

addClass ( classNames )

为当前所有节点添加样式类。

参数：

classNamesString|Array<String>
样式类。多个样式类用空格隔开，或者以数组传入。

返回值：

NodeList当前节点集合。

removeClass ( classNames )

为当前所有节点移除CSS样式类。

参数：

classNamesString|Array<String>
样式类。多个样式类用空格隔开，或者以数组传入； 如果为空，则移除所有样式类。

返回值：

NodeList当前节点集合。

toggleClass ( classNames , [addOrRemove] )

如果节点包含样式类，则移除；如果节点不包含样式类，则添加。

参数：

classNamesString|Array<String>
样式类。多个样式类用空格隔开，或者以数组传入。
[addOrRemove]Boolean
如果值为true，则强制添加样式类； 如果值为false，则强制移除样式类。

返回值：

NodeList当前节点集合。

width ( ) +1

获取当前第一个节点的宽度。

返回值：

Number节点宽度。

width ( val ) +1

设置当前所有节点的宽度。

参数：

valNumber|String
宽度值（支持相对值，如+=N、-=N）。

返回值：

NodeList当前节点集合。

height ( ) +1

获取当前第一个节点的高度。

返回值：

Number节点高度。

height ( val ) +1

设置当前所有节点的高度。

参数：

valNumber|String
高度值（支持相对值，如+=N、-=N）。

返回值：

NodeList当前节点集合。

innerWidth ( )

获取当前第一个节点的内部宽度（包含padding）。

返回值：

Number内部宽度。

innerHeight ( )

获取当前第一个节点的内部高度（包含padding）。

返回值：

Number内部高度。

outerWidth ( [includeMargin=false] )

获取当前第一个节点的外部宽度（包含padding、border）。

参数：

[includeMargin=false]Boolean
是否包含margin。

返回值：

Number外部宽度。

outerHeight ( [includeMargin=false] )

获取当前第一个节点的外部高度（包含padding、border）。

参数：

[includeMargin=false]Boolean
是否包含margin。

返回值：

Number外部高度。

show ( )

显示当前所有节点。

返回值：

NodeList当前节点集合。

hide ( )

隐藏当前所有节点。

返回值：

NodeList当前节点集合。

toggle ( [showOrHide] )

如果第一个节点是隐藏的，则显示所有节点，否则隐藏所有节点。

参数：

[showOrHide]Boolean
强制指定显示或隐藏。 如果此值为true，则显示所有节点； 如果此值为false，则隐藏所有节点。

返回值：

NodeList当前节点集合。

offsetParent ( )

获取当前第一个节点最近的上级定位元素。

返回值：

Element最近的上级定位元素。

offset ( )

获取当前第一个节点相对于document的位置。

返回值：

Object位置（top、left）。

position ( )

获取当前第一个节点相对于最近的上级定位元素的位置。

返回值：

Object位置（top、left）。

scrollTop ( ) +1

获取当前第一个节点内的垂直滚动距离。

返回值：

Number垂直滚动距离。

scrollTop ( val ) +1

设置当前所有节点内的垂直滚动距离。

参数：

valNumber
垂直滚动距离。

返回值：

NodeList当前节点集合。

scrollLeft ( ) +1

获取当前第一个节点内的横向滚动距离。

返回值：

Number横向滚动距离。

scrollLeft ( val ) +1

设置当前所有节点内的横向滚动距离。

参数：

valNumber
横向滚动距离。

返回值：

NodeList当前节点集合。

on ( types , handler , [options] )

在当前所有节点上注册事件监听。

参数：

typesString|Array<String>
事件类型。多个事件类型用空格隔开，或者以数组传入。
handlerFunction(e)
监听函数。
[options]Object
参数。
[options.delegator]String
委托方。可接受后代元素委托。
[options.data]Any
额外传入的数据。可通过事件对象的data属性获得。

返回值：

NodeList当前节点集合。

off ( [types] , [handler] )

在指定节点上移除事件监听。

参数：

[types]String|Array<String>
事件类型。 多个事件类型用空格隔开，或者以数组传入； 如果为空，则移除所有事件类型的监听函数。
[handler]Function
回调函数。 如果为空，则移除指定事件类型的所有监听函数。

返回值：

NodeList当前节点集合。

trigger ( type , [options] )

模拟事件触发。

参数：

typeString
事件类型。
[options]Object
参数设置。
[options.bubbles]Boolean
是否冒泡。
[options.data]Mixed
事件数据。

返回值：

NodeList当前节点集合。

animate ( endStyle , [options] , [returnPromise] )

对当前所有节点执行动画。

参数：

endStyleObject
最终样式。
[options]Object
其他参数。
[options.duration=400]Number
动画时长（毫秒）。
[options.easing='linear']String|Function
缓动函数。
[options.onprogress]Function(value,progress,remaining)
动画每一帧执行后的回调函数。
[options.oncomplete]Function
动画执行完成后的回调函数。
[returnPromise]Boolean
为true时返回动画promise。

返回值：

NodeList|Promise当前节点集合或动画promise。

stop ( [clearQueue=false] , [jumpToEnd=false] )

停止当前所有节点的动画。

参数：

[clearQueue=false]Boolean
是否清理节点的动画队列。
[jumpToEnd=false]Boolean
是否跳跃到当前动画的最后一帧。

返回值：

NodeList当前节点集合。