NodeList#
Wstęp#
Interfejs NodeList stanowi definicję Web IDL dla uporządkowanych kolekcji, których elementami mogą być węzły dowolnego rodzaju. Obiekty typu NodeList
są potocznie nazywane kolekcjami węzłowymi # i skojarzone zostały z kilkoma podstawowymi zagadnieniami.
Kolekcja węzłowa stanowi najogólniejszy rodzaj kolekcji, jaki może pojawić się w dokumentach XML czy HTML. Z racji tego, że jej elementami mogą być dowolne węzły, to w praktyce będzie niewiele poleceń, które mogą taką kolekcję utworzyć. Kolekcja węzłowa, w zależności od użytego polecenia, może być aktualna lub statyczna (ten drugi wariant oznaczono znakiem *
).
Interfejs NodeList nie dziedziczy z żadnego innego interfejsu w ogólnym ujęciu DOM, chociaż w środowisku JS obiekty implementujące ten interfejs będą dziedziczyły z prototypu najwyższego rzędu. Zachowanie takie jest czymś normalnym w przypadku języka ECMAScript.
Kolekcję węzłową można uzyskać za pomocą poleceń zawartych w poniższej tabeli:
NodeList | ||
---|---|---|
DOM4: | HTML5: | |
RadioNodeList | ||
HTML5: |
Właściwości NodeList#
Nazwa | Opis |
---|---|
NodeList.length | Zwraca liczbę węzłów zawartych w danej kolekcji węzłowej. |
Metody NodeList#
Nazwa | Opis |
---|---|
NodeList.item() | Zwraca węzeł o określonym indeksie z danej kolekcji węzłowej. |
Składnia Web IDL#
interface NodeList # { getter Node? item(unsigned long index); readonly attribute unsigned long length; };