Element.up - Prototype JavaScript 框架

Xunxin Prototype API

up

up(element, [cssRule][, index = 0]) -> HTMLElement | undefined

返回 element 的与 cssRule 相匹配的第一个先代节点(如果指定 index 参数,则返回第 index 个)。如果未指定 cssRule,则默认匹配所有先代节点。如果没有符合条件的先代节点,返回 undefined

Element.up 方法是 Prototype 最基本的 DOM 遍历工具之一(其余的还有 Element.downElement.nextElement.previous,这些方法体现了 Prototype 良好的编程风格)。它允许基于索引和/或 CSS 规则对元素的先代节点进行精确选择。

因为它忽略了文本节点(仅返回元素),所以你不必担心空白节点。

还有一个额外的惊喜,所有返回的元素都已经过 扩展,支持链式的调用方式:

$(element).up(1).next('li', 2).hide(); 

遍历 DOM 从不曾像现在这么方便。

参数

如果不传递任何参数,将返回 element 的第一个先代节点(这类似于调用 parentNode,只不过 Element.up 返回一个已 扩展 的元素。

如果 index 参数被传递,将返回 element 的具有相应索引的先代节点。(这等同于从方法 Element.ancestors 返回的元素数组中选择相应的成员。)注意,第一个元素的索引为 0。

如果定义了 cssRule 参数,Element.up 将返回匹配的第一个先代节点。

如果 cssRuleindex 都被定义,Element.up 将会获取所有匹配指定 CSS 规则的先代节点集合, 然后返回指定索引处的元素。

在上述的所有情形中,如果没有找到相应的先代节点,将返回 undefined

样例

<html> 
	[…] 
	
	<body> 
		<ul id="fruits"> 
			<li id="apples" class="keeps-the-doctor-away"> 
				<ul> 
					<li id="golden-delicious">Golden Delicious</li>
					<li id="mutsu" class="yummy">Mutsu</li> 
					<li id="mcintosh" class="yummy">McIntosh</li> 
					<li id="ida-red">Ida Red</li>
				</ul> 
			</li> 
		</ul> 
	</body> 
</html> 
$('fruits').up(); 
// 等同于:
$('fruits').up(0); 
// -> body 
$('mutsu').up(2); 
// -> ul#fruits 
$('mutsu').up('li'); 
// -> li#apples 
$('mutsu').up('.keeps-the-doctor-away');
// -> li#apples 
$('mutsu').up('ul', 1); 
// -> ul#fruits 
$('mutsu').up('div'); 
// -> undefined