Element.recursivelyCollect - Prototype JavaScript 框架

Xunxin Prototype API

recursivelyCollect

recursivelyCollect(element, property) -> [HTMLElement...]

通过递归获取和 element 相关的元素集合,元素的相关性由 property 参数指定,property 必须是 element 的一个属性(不能为方法!),指向单个 DOM 节点。该方法返回一个数组,数组元素已经过 扩展

该方法用于在 Element.ancestorsElement.descendantsElement.nextSiblingsElement.previousSiblingsElement.siblings 的内部,提供简捷的获取元素的途径,一般不需要直接访问它。当然, 如果你有一些不同寻常的需求,也可以选择使用它。

注意:所有 Prototype 的 DOM 扩展方法均忽略文本节点,仅返回元素节点。

样例

<ul id="fruits">
	<li id="apples"> 
		<ul id="list-of-apples">
			<li id="golden-delicious"><p>Golden Delicious</p></li>
			<li id="mutsu">Mutsu</li>
			<li id="mcintosh">McIntosh</li>
			<li id="ida-red">Ida Red</li>
		</ul> 
	</li> 
</ul> 
$('fruits').recursivelyCollect('firstChild'); 
// -> [li#apples, ul#list-of-apples, li#golden-delicious, p]