document.getElementsByClassName
不推荐
document.getElementsByClassName(className[, element]) -> [HTMLElement...]
返回(并扩展)所有具有参数 className
指定的 CSS 类名的元素。可选的 element
参数用于指定搜索范围(仅搜索该元素下的子节点)。
在 Prototype 1.6 中,不建议使用 document.getElementsByClassName
,因为这个函数的原始实现是返回一个 NodeList
,而不是一个 Array
。在 v1.6 中,请使用 $$
或 Element#select
代替。
注意返回的所有元素都已经被扩展。
样例
HTML
<body>
<div id="one" class="foo">
单个类名称
</div>
<div id="two" class="foo bar thud">
多重类名称
</div>
<ul id="list">
<li id="item_one" class="thud">List item 1</li>
<li>List item 2</li>
<li id="item_two" class="thud">List item 3</li>
</ul>
</body>
JavaScript
document.getElementsByClassName('foo');
// -> [HTMLElement, HTMLElement] (div#one, div#two)
document.getElementsByClassName('thud');
// -> [HTMLElement, HTMLElement, HTMLElement] (div#two, li#item_one, li#item_two);
document.getElementsByClassName('thud', $('list'));
// -> [HTMLElement, HTMLElement] (li#item_one, li#item_two)