NamedNodeMap#
Wstęp#
Interfejs NamedNodeMap stanowi definicję Web IDL dla obiektów reprezentujących wszystkie atrybuty w węzłach elementowych. Obiekty typu NamedNodeMap są potocznie nazywane mapami nazwanych atrybutów # i skojarzone zostały z kilkoma podstawowymi zagadnieniami.
Chociaż atrybuty, zgodnie z najnowszymi wymaganiami specyfikacji DOM4, nie powinny dziedziczyć poleceń węzłowych, to jednak nazwę interfejsu "NamedNodeMap" pozostawiono ze względów historycznych.
Interfejs NamedNodeMap 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.
Mapę nazwanych atrybutów można uzyskać za pomocą właściwości:
Właściwości NamedNodeMap#
| Nazwa | Opis |
|---|---|
NamedNodeMap.length | Zwraca liczbę atrybutów z listy atrybutów. |
Metody NamedNodeMap#
| Nazwa | Opis |
|---|---|
NamedNodeMap.getNamedItem() | Zwraca pierwszy atrybut o określonej nazwie kwalifikowanej z listy atrybutów. |
NamedNodeMap.getNamedItemNS() | Zwraca atrybut o określonej przestrzeni nazw i nazwie lokalnej z listy atrybutów. |
NamedNodeMap.item() | Zwraca atrybut o określonym indeksie z listy atrybutów. |
NamedNodeMap.removeNamedItem() | Usuwa pierwszy atrybut o określonej nazwie kwalifikowanej z listy atrybutów i zwraca referencję do usuniętego atrybutu. |
NamedNodeMap.removeNamedItemNS() | Usuwa atrybut o określonej przestrzeni nazw i nazwie lokalnej z listy atrybutów i zwraca referencję do usuniętego atrybutu. |
NamedNodeMap.setNamedItem() | Dodaje lub zastępuje pasujący pod względem przestrzeni nazw i nazwy lokalnej istniejący atrybut przekazanym atrybutem w liście atrybutów i w zależności od sytuacji zwraca odpowiednie wartości. |
NamedNodeMap.setNamedItemNS() | Dodaje lub zastępuje pasujący pod względem przestrzeni nazw i nazwy lokalnej istniejący atrybut przekazanym atrybutem w liście atrybutów i w zależności od sytuacji zwraca odpowiednie wartości. |
Składnia Web IDL#
[LegacyUnenumerableNamedProperties] interface NamedNodeMap # { readonly attribute unsigned long length; getter Attr? item(unsigned long index); getter Attr? getNamedItem(DOMString qualifiedName); Attr? getNamedItemNS(DOMString? namespace, DOMString localName); Attr? setNamedItem(Attr attr); Attr? setNamedItemNS(Attr attr); Attr removeNamedItem(DOMString qualifiedName); Attr removeNamedItemNS(DOMString? namespace, DOMString localName); };