DOM | Интерфейс HTMLCollection

DOM | Интерфейс HTMLCollection

IDL

[Exposed=Window, LegacyUnenumerableNamedProperties]
interface HTMLCollection {
   readonly attribute unsigned long length;
   getter Element? item(unsigned long index);
   getter Element? namedItem(DOMString name);
};

 

Объект HTMLCollection — это коллекция элементов.

Примечание! HTMLCollection — это исторический артефакт, от которого сеть не может избавиться. Хотя разработчики, конечно, могут продолжать его использовать, разработчики новых стандартов API не должны его использовать (вместо этого используйте sequence<T> в IDL).

 

Для веб-разработчиков (не нормативно)

collection . length

Возвращает количество элементов в коллекции.

element = collection . item(index)

element = collection[index]

Возвращает элемент с индексом index из коллекции. Элементы отсортированы в древовидном порядке.

element = collection . namedItem(name)

element = collection[name]

Возвращает первый элемент с идентификатором или именем name из коллекции.

 

Индексы поддерживаемых свойств объекта — это числа в диапазоне от нуля до количества элементов минус один, представленных коллекцией. Если таких элементов нет, то индексы поддерживаемых свойств отсутствуют.

Получатель атрибута length должен возвращать количество узлов, представленных коллекцией.

При вызове метода item(index) он должен возвращать indexный элемент в коллекции. Если в коллекции нет indexного элемента, метод должен возвращать значение null.

 

Имена поддерживаемых свойств — это значения из списка, возвращаемого этими шагами:

1. Пусть result будет пустым списком.
2. Для каждого элемента element, представленного коллекцией, в древовидном порядке:
   1. Если элемент element имеет идентификатор ID, которого нет в результате result, добавьте идентификатор ID элемента element к результату result.
   2. Если элемент element находится в пространстве имен HTML и имеет атрибут имени name, значение которого не является ни пустой строкой, ни результатом result, добавьте значение атрибута имени name элемента element к результату result.
3. Верните result

 

При вызове метода namedItem(key) необходимо выполнить следующие действия:

1. Если ключ key - это пустая строка, верните ноль(null).
2. Вернуть первый элемент в коллекции, для которого верно хотя бы одно из следующего:
   - у него есть ID, который является ключом key;
   - он находится в пространстве имен HTML и имеет атрибут имени name, значение которого является ключом key;

или null, если такого элемента нет.

 

Ссылки

DOM стандарт — https://efim360.ru/dom/

Читайте перевод полной версии стандарта «объектной модели документа», чтобы ознакомиться со всеми концепциями и интерфейсами.

DOMLiving Standardhttps://dom.spec.whatwg.org

Читайте официальную документацию живого стандарта «объектной модели документа», чтобы быть в курсе последних изменений.