DOM:element.setAttribute

z Mozilla Developer Center, polskiego centrum programistów Mozilli.

« Dokumentacja Gecko DOM

Spis treści 1 Podsumowanie 2 Składnia 3 Parametry 4 Przykład 5 Uwagi 6 Specyfikacja

[edytuj] Podsumowanie

setAttribute dodaje nowy lub zmienia wartość atrybutu w bieżącym elemencie.

[edytuj] Składnia

element.setAttribute(nazwa, wartość) 

[edytuj] Parametry

• nazwa to łańcuch znaków z nazwą nowego atrybutu,
• wartość to żądana wartość nowego atrybutu.

[edytuj] Przykład

d = document.getElementById("d1"); 
d.setAttribute("align", "center");

[edytuj] Uwagi

Jeśli istnieje już atrybut o danej nazwie, jego wartość zostaje zmieniona na wartość podaną w wywołaniu setAttribute. Jeśli nie istnieje taki atrybut, zostanie on utworzony.

Pomimo, że getAttribute zwraca null jeśli atrybut nie istnieje, do usuwania atrybutów powinieneś używać metody removeAttribute, a nie element.setAttribute(attr, null).

Metody DOM do obsługi atrybutów to:

DOM Level 1 (brak obsługi przestrzeni nazw, najczęściej używane)	DOM Level 2 (obsługa przestrzeni nazw)	DOM Level 1 - praca bezpośrednio z węzłami Attr (rzadko używane)	DOM Level 2 - praca bezpośrednio z węzłami Attr, z obsługą przestrzeni nazw (rzadko używane)
setAttribute	setAttributeNS	setAttributeNode	setAttributeNodeNS
getAttribute	getAttributeNS	getAttributeNode	getAttributeNodeNS
hasAttribute	hasAttributeNS	-	-
removeAttribute	removeAttributeNS	removeAttributeNode	-

[edytuj] Specyfikacja

DOM Level 2 Core: setAttribute (wprowadzono w DOM Level 1 Core)