HTMLCollection

属性

HTMLCollection.length 只读

返回集合当中子元素的数目。

方法

HTMLCollection.item()

根据给定的索引（从 0 开始），返回具体的节点。如果索引超出了范围，则返回 null。

访问 collection[i]（在索引 i 超出范围时会返回 undefined）的替代方法。这在非 JavaScript DOM 的实现中非常有用。

HTMLCollection.namedItem()

根据 ID 返回指定节点，若不存在，则根据字符串所表示的 name 属性来匹配。根据 name 匹配只能作为最后的依赖，并且只有当被引用的元素支持 name 属性时才能被匹配。如果不存在符合给定 name 的节点，则返回 null。

访问 collection[name]（在 name 不存在时会返回 undefined）的替代方法。这在非 JavaScript DOM 的实现中非常有用。

在 JavaScript 中使用

HTMLCollection 还通过将其成员的名称和索引直接以属性的形式公开。HTML ID 可能会包含在 ID 中合法的 : 和 . 字符，这时就需要使用括号表达式来访问属性。目前，HTMLCollection 不能识别纯数字的 ID，因为这与数组形式的访问相冲突（虽然 HTML5 允许使用纯数字的 ID）。

例如，假定在文档中有一个 <form> 元素，且它的 id 是 myForm：

var elem1, elem2;

// document.forms is an HTMLCollection

elem1 = document.forms[0];
elem2 = document.forms.item(0);

alert(elem1 === elem2); // shows: "true"

elem1 = document.forms.myForm;
elem2 = document.forms.namedItem("myForm");

alert(elem1 === elem2); // shows: "true"

elem1 = document.forms["named.item.with.periods"];

规范

浏览器兼容性

参见

• NodeList
• HTMLFormControlsCollection、HTMLOptionsCollection