Metoda XML DOM getElementById()
Definicja i użycie
Metoda getElementById() wyszukuje element o określonym unikalnym ID.
Gramatyka:
getElementById(elementid)
| Parametry | Opis |
|---|---|
| elementid | Wartość atrybutu id elementu, którego chcesz uzyskać. |
Zwracana wartość
Element Node reprezentujący dokumentowy element o określonym atrybucie id. Jeśli nie znajdzie takiego elementu, zwróci null.
Opis
Ta metoda będzie wyszukiwać wartości atrybutu id elementid węzła elementu i zwróci go. Jeśli nie znajdzie takiego węzła, zwróci null. Wartość atrybutu id jest unikalna w dokumencie, jeśli ta metoda znajdzie więcej elementów z określonym elementid węzła elementu, który losowo zwróci taki węzeł elementu lub zwróci null.
To jest ważna i często używana metoda, ponieważ oferuje prosty sposób uzyskania obiektu Element reprezentującego określony element dokumentu.
Uwaga:Nazwa tej metody kończy się na Id, nie ID, nie poprawiaj tego.
W dokumencie HTML, ta metoda zawsze wyszukuje atrybut o określonym id. Można użyć Metoda getElementByName() HTMLDocument, aby znaleźć elementy HTML na podstawie wartości atrybutu name.
W dokumencie XML, ta metoda jest używana do wyszukiwania dowolnego atrybutu o typie id, niezależnie od nazwy tego atrybutu. Jeśli typ atrybutu XML jest nieznany (np. parser XML zignorował lub nie mógł zlokalizować DTD dokumentu), metoda zawsze zwraca null. W JavaScriptie klientowym, ta metoda rzadko jest używana z dokumentami XML. W rzeczywistości, getElementById() pierwotnie został zdefiniowany jako członek interfejsu HTMLDocument, ale w późniejszym poziomie DOM 2 został przeniesiony do interfejsu Document.
