Element

Ten rozdział dostarcza zwięzłych informacji dla wszystkich metod, własności i zdarzeń dostępnych dla większości elementów HTML i XML w Gecko DOM.

Różne specyfikacje W3C mają zastosowanie do elementów:

  • DOM Core Specification—opisuje główne interfejsy współdzielone przez większość obiektów DOM w dokumentach HTML i XML
  • DOM HTML Specification—opisuje interfejsy dla obiektów w dokumentach HTML i XHTML tworzonych na głównej specyfikacji
  • DOM Events Specification—opisuje zdarzenia współdzielone przez większość obiektów DOM, tworzone na głównej specyfikacji DOM i specyfikacji Views

Niniejsze interfejsy DOM łączą różne specyfikacje, jednak staramy się skoncentrować na rekomendacji DOM Level 2 HTML. Każda podstrona zawiera odnośnik do odpowiedniego fragmentu specyfikacji W3C DOM.

W tym miejscu "elementy" oznaczają ten interfejs, jaki mają wszystkie elementy HTML i XML. Istnieją również bardziej specjalizowane interfejsy dla poszczególnych elementów - np. BODY posiada dodatkowe funkcje i własności, podobnie tabele. W tym rozdziale omówiony jest tylko ten interfejs, jak współdzielą wszystkie elementy.

Własności

Nazwa Opis Typ Dostępność
attributes Zwraca tablicę atrybutów elementu. NamedNodeMap Wszystkie
childNodes Zwraca tablicę węzłów potomnych elementu. NodeList Wszystkie
className Pobiera/ustawia klasę elementu. String HTML, XUL
clientHeight Zwraca wewnętrzną wysokość elementu. Number HTML
clientWidth Zwraca wewnętrzną szerokość elementu. Number HTML
dir Ustawia lub pobiera kierunek elementu. String HTML, XUL
firstChild Zwraca pierwsze dziecko bieżącego węzła lub null, jeśli ten element nie posiada węzła potomnego. Node Wszystkie
id Pobiera/ustawia id elementu. String HTML, XUL
innerHTML Pobiera/ustawia znacznik zawartości elementu. String HTML
lang Określa język bazowy dla wartość atrybutów i tekstowej zawartości elementu. String HTML
lastChild Zwraca ostatnie dziecko bieżącego węzła elementu lub null jeśli ten element nie posiada węzłów potomnych. Node Wszystkie
localName Zwraca lokalną część uściślonej nazwy węzła. String Wszystkie
Nazwa Opis Typ Dostępność
name Pobiera lub ustawia atrybut name - dostępne nie dla wszystkich elementów. String HTML
namespaceURI URI przestrzeni nazw węzła lub null, jeśli jest bliżej nieokreślony. String Wszystkie
nextSibling Węzeł bezpośrednio następny w drzewie dokumentu lub null jeżeli takiego nie ma. Node Wszystkie
nodeName Nazwa węzła. String Wszystkie
nodeType Cyfra reprezentująca typ węzła. 1 oznacza element DOM. Number Wszystkie
nodeValue Wartość węzła atrybutu, zawartość węzła tekstowego lub null dla elementu DOM. String Wszystkie
offsetHeight Wysokość elementu, odnosząca się do układu strony. Number HTML
offsetLeft Odległość pomiędzy lewą krawędzią elementu, a jego offsetParent lewej krawędzi. Number HTML
offsetParent Element, od którego obliczane są wszystkie przesunięcia. Element HTML
offsetTop Odległość pomiędzy górną krawędzią elementu, a jego offsetParent górnej krawędzi. Number HTML
offsetWidth Szerokość elementu, odnosząca się do układu strony. Number HTML
ownerDocument Dokument, którego węzeł jest w lub null jeśli węzeł nie znajduje się wewnątrz. Document Wszystkie
Nazwa Opis Typ Dostępność
parentNode Element nadrzędny bieżącego węzła lub null jeżeli węzeł nie znajduje się wewnątrz dokumentu DOM. Node Wszystkie
prefix Prefiks przestrzeni nazw węzła lub null jeżeli nie określono prefiksa. String Wszystkie
previousSibling Węzeł bezpośrednio poprzedni w drzewie dokumentu lub null jeżeli takiego nie ma. Node Wszystkie
scrollHeight The scroll view height of an element. Number HTML
scrollLeft Gets/sets the left scroll offset of an element. Number HTML
scrollTop Gets/sets the top scroll offset of an element. Number HTML
scrollWidth The scroll view width of an element. Number HTML
style Obiekt reprezentujący deklaracje stylów elementu. CSSStyle HTML, XUL
tabIndex Pobiera lub ustawia pozycję elementu w kolejności przechodzenia tabulatorem. Number HTML
tagName Nazwa znacznika HTML danego elementu. String Wszystkie
textContent Pobiera bądź ustawia tekstową treść elementu i jego potomków. String Wszystkie

 

attributes
Zwraca tablicę atrybutów elementu.
childNodes
Zwraca tablicę węzłów potomnych elementu
className
Pobiera/ustawia klasę elementu.
clientHeight
Własność DHTML-a, reprezentuje wewnętrzną wysokość elementu.
clientLeft
Długość od lewego obramowania elementu wyrażona w pikselach. Aktualnie nie obsługiwana.
clientTop
Długość od górnego obramowania elementu wyrażona w pikselach. Aktualnie nie obsługiwana.
clientWidth
Własność DHTML-a, reprezentuje wewnętrzną szerokość elementu.
dir
Pobiera/ustawia kierunkowość (ang. directionality) elementu.
firstChild
Zwraca pierwsze dziecko bieżącego węzła.
id
Pobiera/ustawia id elementu.
innerHTML
innerHTML zwraca całą zawartość elementu wraz ze znacznikami.
lang
Określa język bazowy dla wartość atrybutów i tekstowej zawartości elementu.
lastChild
Zwraca ostatnie dziecko bieżącego węzła.
length
Zwraca ilość elementów listy (np. childNodes).
localName
Zwraca lokalną część uściślonej nazwy węzła.
name
Pobiera lub ustawia atrybut name - dostępne nie dla wszystkich elementów.
namespaceURI
URI przestrzeni nazw węzła lub NULL, jeśli nie określono przestrzeni nazw.
nextSibling
Zwraca węzeł bezpośrednio następny w drzewie dokumentu.
nodeName
Zwraca nazwę biężącego węzła.
nodeType
Zwraca typ bieżącego węzła.
nodeValue
Zwraca wartość bieżącego węzła.
offsetHeight
offsetHeight jest własnością DHTML-a, zwracającą wysokość elementu względem układu.
offsetLeft
offsetLeft pobiera/ustawia ilość pikseli, jaka dzieli element od lewej strony wewnątrz węzła offsetParent.
offsetParent
offsetParent zwraca referencję do obiektu, w którym obecny element się znajduje (tj. rodzica).
offsetTop
offsetTop zwraca pozycję obecnego elementu względem góry węzła offsetParent.
offsetWidth
offsetWidth jest własnością DHTML-a, zwracającą szerokość elementu względem układu.
ownerDocument
Zwraca dokument, w którym znajduje się bieżący węzeł.
parentNode
Zwraca rodzica bieżącego węzła.
prefix
Zwraca prefiks przestrzeni nazw obecnego węzła bądź NULL, jeśli nie określono przestrzeni nazw.
previousSibling
Zwraca węzeł bezpośrednio poprzedni w drzewie dokumentu.
scrollHeight
Własność DHTML-a, zwraca wysokość zawartości elementu z paskiem przewijania.
scrollLeft
pobiera bądź ustawia liczbę pikseli, o którą zostanie przewinięta zawartość dokumentu. Kierunek przewijania odbywa się w lewo.
scrollTop
Własność DHTML-a, która ustawia bądź pobiera odległość między górą elementu a najwyższym punktem zawartości elementu z paskiem przewijania.
scrollWidth
Zwraca the width of the scroll view of an element.
style
Zwraca blok reguł stylów dla elementu.
tabIndex
Pobiera/ustawia pozycję elementu w porządku tabulacji.
tagName
Zwraca nazwę elementu.
textContent
Pobiera/ustawia zawartość tekstu elementu włączając jego potomków.

Metody

addEventListener
Pozwala zarejestrować obserwatora zdarzeń dla celu zdarzenia.
appendChild
Wstawia określony węzeł do listy węzłów dokumentu.
blur
Dezaktywuje bieżący element.
click
Wywołuje kliknięcie na elemencie.
cloneNode
Zwraca kopię bieżącego węzła.
dispatchEvent
Pozwala przekazać wywołania zdarzeń do modelu zdarzeń w implementacji DOM.
focus
Aktywuje bieżący element.
getAttribute
Zwraca wartość atrybutu o podanej nazwie.
getAttributeNS
Zwraca wartość atrybutu o podanej nazwie i przestrzeni nazw.
getAttributeNode
Zwraca atrybut elementu jako osobny węzeł.
getElementsByTagName
Zwraca elementy o podanej nazwie będące potomkami bieżącego elementu.
hasAttribute
Zwraca wartość logiczną zależnie od tego, czy element posiada atrybut o podanej nazwie.
hasAttributeNS
Zwraca wartość logiczną zależnie od tego, czy element posiada atrybut o podanej nazwie i przestrzeni nazw.
hasAttributes
Zwraca wartość logiczną zależnie od tego, czy element posiada jakiekolwiek atrybuty.
hasChildNodes
Zwraca wartość logiczną zależnie od tego, czy element posiada dzieci.
insertBefore
Metoda pozwala wstawić węzeł przed bieżącym elementem w DOM.
item
Zwraca węzeł z drzewa wg podanego indeksu.
normalize
Metoda zapisuje bieżący węzeł i całe drzewo znajdujące się wewnątrz w "znormalizowanej" formie.
removeAttribute
Usuwa atrybut elementu.
removeAttributeNode
Usuwa określony atrybut elementu.
removeChild
Usuwa węzeł potomny bieżącego elementu.
removeEventListener
Pozwala usunąć obserwatora zdarzeń z celu zdarzenia.
replaceChild
Metoda replaceChild() zastępuje węzeł potomny bieżącego elementu innym węzłem.
setAttribute
Dodaje nowy atrybut bądź zmienia wartość atrybutu bieżącego elementu.
setAttributeNS
Dodaje nowy atrybut bądź zmienia wartość atrybutu bieżącego elementu, wg podanej nazwy i przestrzeni nazw.
setAttributeNode
Dodaje nowy węzeł atrybutu do bieżącego elementu.
setAttributeNodeNS
Dodaje nowy węzeł atrybutu do bieżącego elementu wg podanej nazwy i przestrzeni nazw.
supports
Sprawdza, czy implementacja DOM pozwala na wykorzystanie konkretnej możliwości.

Uchwyty zdarzeń

Poniższe właściwości nie mogą być przypisane, tak jak uchwyty zdarzeń obiektów document czy window. Wszystkie poniższe własności służą tylko do odczytu - zwracają kod obsługi zdarzeń, jeżeli został on nadany elementowi w samym HTML-u bądź XML-u.

These are properties that correspond to the HTML 'on' event attributes.

Unlike the corresponding attributes, the values of these properties are functions (or any other object implementing the EventListener interface) rather than a string. In fact, assigning an event attribute in HTML creates a wrapper function around the specified code. For example, given the following HTML:

<div onclick="foo();">click me!</div>

If element is a reference to this div, the value of element.onclick is effectively:

function onclick(event) {
   foo();
}

Note how the event object is passed as parameter event to this wrapper function.

onblur
Zwraca kod obsługi zdarzenia blur.
onclick
Zwraca kod obsługi zdarzenia onclick.
ondblclick
Zwraca kod obsługi zdarzenia dblclick.
onfocus
Zwraca kod obsługi zdarzenia focus.
onkeydown
Zwraca kod obsługi zdarzenia keydown.
onkeypress
Zwraca kod obsługi zdarzenia keypress.
onkeyup
Zwraca kod obsługi zdarzenia keyup.
onmousedown
Zwraca kod obsługi zdarzenia mousedown.
onmousemove
Zwraca kod obsługi zdarzenia mousemove.
onmouseout
Zwraca kod obsługi zdarzenia mouseout.
onmouseover
Zwraca kod obsługi zdarzenia mouseover.
onmouseup
Zwraca kod obsługi zdarzenia mouseup.
onresize
Zwraca kod obsługi zdarzenia resize.

Autorzy i etykiety dokumentu

Etykiety: 
Ostatnia aktualizacja: fscholz,