Element.down - Prototype JavaScript 框架

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

返回 element 下与 cssRule 相匹配的第一个后代节点（如果指定 index 参数，则返回第 index 个）。如果未指定 cssRule，则默认匹配所有后代节点。如果没有符合条件的后代节点，返回 undefined。

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

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

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

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

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

参数

如果不传递任何参数，将返回 element 的第一个后代节点（这类似于调用 firstChild，只不过 Element.down 返回一个已 扩展 的元素。

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

如果定义了 cssRule 参数，Element.down 将返回匹配的第一个后代节点。如果要从一个列表中获取第一个项目， 这是一个非常好的方法（只要传递 <li> 作为方法的第一个参数就可以了）。

如果 cssRule 和 index 都被定义，Element.down 将会获取所有匹配指定 CSS 规则的元素集合， 然后返回指定索引处的元素。

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

样例

<ul id="fruits">
	<li id="apples">
		<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> 

$('fruits').down();
// 等同于：$('fruits').down(0);
// -> li#apple
$('fruits').down(3);
// -> li#golden-delicious
$('apples').down('li');
// -> li#golden-delicious
$('apples').down('li.yummy');
// -> li#mutsu
$('fruits').down('.yummy', 1);
// -> li#mcintosh
$('fruits').down(99);
// -> undefined