ElementNN 6 IE nicht zutreffend DOM 1

Das Element-Objekt des W3C-DOM stammt aus dem Core-Modul und stellt die Art von Elementobjekt dar, die Sie in echten XML-Dokumenten finden. Dieser Nodetyp erbt Eigenschaften und Methoden vom Root-Node-Objekt und fügt Fähigkeiten hinzu, die ihn in die Lage versetzen, als Container für andere Nodes zu fungieren. Die Elemente in HTML-Dokumenten sind vom Typ HTMLDocument, der vom Element-Objekt erbt. Wie am Anfang dieses Kapitels beschrieben, weisen alle HTML-Elementobjekte sämtliche Eigenschaften und Methoden des Element-Objekts auf.

 
Objektmodellreferenz
 
elementNodeReference
 
Objektspezifische Eigenschaften

Keine.

 
Objektspezifische Methoden

Keine.

 
Objektspezifische Ereignisbehandlungsroutineneigenschaften

Keine.

all[ ]NN nicht zutreffend IE 4 DOM nicht zutreffend

Schreibgeschützt

Gibt ein Array aller HTML-Elementobjekte zurück, die im aktuellen Dokument enthalten sind. Elemente in diesem Array werden in der Quellcodereihenfolge (basierend auf Null) indiziert. Die Sammlung umfasst Generationen verschachtelter Elemente, sodass document.all[ ] sämtliche Elemente im gesamten Dokument offen legt. Eine Liste der Eigenschaften und Methoden dieses Eigenschaftswerts finden Sie in der Abhandlung des all-Objekts.

 

Wie bei allen Sammlungen können Sie in Internet Explorer sowohl die herkömmliche JavaScript-Arraysyntax mit dem Indexwert in eckigen Klammern als auch die alternative IE-Schreibweise mit dem Indexwert in runden Klammern verwenden. Sollten Sie auf browserübergreifende Kompatibilität Wert legen und Sammlungen verwenden, die auf beiden Plattformen zur Verfügung stehen, verwenden Sie die Schreibweise mit eckigen Klammern.

 

Sofern Sie nicht ausschließlich für IE-Browser entwickeln, sollten Sie eine Umstellung auf W3C-DOM-Referenzen mithilfe der Methode document.getElementByID in Betracht ziehen, die in IE ab Version 5 und Netscape 6 implementiert ist.

 
Beispiel
 
var inpVal = document.all.first_name.value;
 
Wert

Array (Sammlung) mit Elementobjektreferenzen in der HTML-Quellcodereihenfolge.

 
Standardwert

Modell des aktuellen Dokuments.

attachEvent( )NN nicht zutreffend IE 5(Win) DOM nicht zutreffend

attachEvent("eventName", functionReference)

Bindet eine Ereignisbehandlungsroutinenfunktion an ein Elementobjekt für einen bestimmten Ereignistyp. Bei ähnlicher Funktionsweise wie die W3C-DOM-Methode addEventListener( ) wird die IE-Methode attachEvent( ) hauptsächlich für IE Verhalten verwendet. Bei regulären HTML-Seiten ist es browserübergreifend gesehen besser, Elemente mithilfe der Ereignisbehandlungsroutineneigenschaften von Elementobjekten zu binden. Wenn Sie eine Ereignisbehandlungsroutine mithilfe der Methode attachEvent( ) binden, können Sie die Bindung mit der Methode detachEvent( ) wieder aufheben.

 
Parameter
 
  • Zeichenfolgenversion des Ereignisnamen einschließlich des Präfix "on". Anwendbar auf alle Ereignistypen, die in der umfangreichen Liste gemeinsamer IE/Windows-Ereignistypen weiter hinten in diesem Abschnitt aufgeführt sind. Die Groß-/Kleinschreibung spielt keine Rolle, doch wird empfohlen, für die Werte nur Kleinbuchstaben zu verwenden.
  • Eine Referenz auf die Funktion, die ausgeführt werden soll, wenn das Element entweder in seiner Eigenschaft als Ereignisziel oder im Rahmen der Ereignisverbreitung das Ereignis empfängt. Da es sich hierbei um eine Referenz auf ein Funktionsobjekt handelt, darf der Name weder in Klammern stehen noch die Klammern der Funktion enthalten. Der Funktion können keine Parameter übergeben werden.
 
Zurückgegebener Wert

Boolescher Wert true bei erfolgreicher Bindung.

behaviorUrns[ ]NN nicht zutreffend IE 5(Win) DOM nicht zutreffend

Schreibgeschützt

Stellt ein Array mit den Uniform Resource Names (URNs) aller externer Verhalten (.htc-Dateien) bereit, die über die Stylesheet-Syntax mit dem Element verknüpft sind. Die in diesem Array eingetragenen Zeichenfolgen sind, wahrscheinlich aus Sicherheitsgründen, immer leer.

 
Beispiel
 
var htcCount = document.getElementById(elementID).behaviorUrns.length;
 
Wert

Array mit (leeren) Zeichenfolgen.

 
Standardwert

Array mit einer Länge von 0.

canHaveChildrenNN nicht zutreffend IE 5(Win) DOM nicht zutreffend

Schreibgeschützt

Legt fest, ob das aktuelle Element als Container für andere Elemente dienen kann. Der Eigenschaftswert basiert auf den eingebauten HTML-DTDs von IE für Windows, die verschiedene Elemente definieren, denen keine Child-Nodes hinzugefügt werden können (z. B. <br>).

 
Beispiel
 
if (elementRef.canHaveChildren) {
		    // statements to insert or append child elements
		}
 
Wert

Boolescher Wert: true | false.

 
Standardwert

Elementspezifisch.

children[ ]NN nicht zutreffend IE 4 DOM nicht zutreffend

Schreibgeschützt

Gibt ein Array aller HTML-Elementobjekte der ersten Ebene zurück, die im aktuellen Dokument enthalten sind. Diese Sammlung unterscheidet sich von der Sammlung all[ ] insofern, als sie nur Referenzen auf die unmittelbaren Child-Objekte des aktuellen Elements enthält, während die Sammlung all[ ] sämtliche Generationen umfasst. Die Sammlung document.body.children[ ] könnte beispielsweise ein Formular, jedoch keine Referenz auf die in diesem Formular verschachtelten Formularelemente enthalten. Elemente in diesem Array werden in der Quellcodereihenfolge (basierend auf Null) indiziert. Im Gegensatz zum Array childNodes[ ] bezieht sich diese Eigenschaft auf das Element und nicht auf die Node. Siehe children-Objekt.

 
Beispiel
 
for (var i = 0; i < elementRef.children.length; i++) {
		    if (elementRef.children[i].tagName == "FORM") {
		        // operate on a form element
		    }
		}
 
Wert

Array mit Elementobjektreferenzen.

 
Standardwert

Array mit einer Länge von Null.

classNameNN 6 IE 4 DOM 1

Lesen/Schreiben

Dies ist ein Bezeichner, der im Allgemeinen verwendet wird, um ein Element einer für einen Class-Selektor definierten Stylesheet-Regel zuzuordnen. Sie können die Klassenzuordnung für ein Element in einem Skript ändern. Wenn das Dokument einen alternativen Klassenselektor und die entsprechende Stilregel enthält, lassen sich durch Anpassen der className-Eigenschaft des Elements eine ganze Reihe von Stileigenschaften rasch und mühelos in einem Arbeitsgang ändern.

 
Beispiel
 
document.getElementById("elementID").className = "altHighlighted";
 
Wert

Zeichenfolge (Groß-/Kleinschreibung beachten). Mehrere Klassennamen in der Zeichenfolge werden durch Leerzeichen voneinander getrennt.

 
Standardwert

Leere Zeichenfolge.

hideFocusNN nicht zutreffend IE 5.5(Win) DOM nicht zutreffend

Lesen/Schreiben

Legt fest, ob der Browser ein Element, das den Fokus besitzt, mit einem gepunkteten Rechteck kennzeichnen soll. Unabhängig von dieser Einstellung kann das Element den Fokus erhalten, wenn es sich um ein standardmäßig aktivierbares Element handelt oder das Attribut tabindex gesetzt ist. Wenn diese Eigenschaft auf true gesetzt ist, wird der Fokusstatus des betreffenden Elements nicht optisch angezeigt.

 
Beispiel
 
document.getElementById("elementID").hideFocus = true;
 
Wert

Boolescher Wert: true | false.

 
Standardwert

false

idNN 6 IE 4 DOM 1

Lesen/Schreiben

Legt einen eindeutigen Bezeichner fest, der das Element vom Rest des Dokuments unterscheidet. Der id-Wert wird in aller Regel in Elementreferenzen verwendet, kann jedoch auch als Kriterium beim Durchsuchen einer Elementsammlung genutzt werden. Bei einem Element, das bereits im Dokumentbaum enthalten ist, sollte der Wert dieser Eigenschaft in der Regel nicht geändert werden. Wenn jedoch ein Skript ein neues Elementobjekt erstellt (z. B. mithilfe der Methode document.createElement( )), kann es der Eigenschaft id dieses Objekts einen eindeutigen Bezeichner zuweisen und es anschließend dem Dokumentbaum hinzufügen.

 
Beispiel
 
var headID = document.getElementsByTagName("head")[0].id;
 
Wert

Zeichenfolge.

 
Standardwert

Leere Zeichenfolge.

innerTextNN nicht zutreffend IE 4 DOM nicht zutreffend

Lesen/Schreiben

Gibt den dargestellten Text (nicht jedoch die Tags) des aktuellen Elements an. Wenn Sie auf den dargestellten Text einschließlich aller verschachtelten HTML-Tags zugreifen möchten, verwenden Sie die Eigenschaft innerHTML. Änderungen an dieser Eigenschaft werden vom HTML-Parser nicht wiedergegeben, d. h. HTML-Tags, die Sie hinzufügen, werden lediglich als darstellbare Textinhalte behandelt. Sie können diese Eigenschaft erst ändern, nachdem das Dokument vollständig geladen wurde. Änderungen an der Eigenschaft innerText werden im Quellcode nicht widergespiegelt, wenn Sie die Quelle im Browser anzeigen. In IE 4 für den Macintosh wird diese Eigenschaft bei vielen Objekten nicht unterstützt.

 
Beispiel
 
document.getElementById("elementID").innerText = "How now brown cow?";
 
Wert

Zeichenfolge.

 
Standardwert

Leere Zeichenfolge.

isContentEditableNN nicht zutreffend IE 5.5(Win) DOM nicht zutreffend

Schreibgeschützt

Legt fest, ob der Benutzer das aktuelle Element in IE/Windows bearbeiten kann. Legt den tatsächlichen Bearbeitungsstatus offen, der entweder explizit für das Element festgelegt oder von einem übergeordneten Element geerbt wurde.

 
Beispiel
 
if (document.getElementById("elementID").isContentEditable) {
		    // process the editable element
		}
 
Wert

Boolescher Wert: true | false.

 
Standardwert

false

isMultiLineNN nicht zutreffend IE 5.5(Win) DOM nicht zutreffend

Schreibgeschützt

Legt fest, ob sich der Inhalt des aktuellen Elements über mehrere Zeilen erstrecken darf. Die meisten Textcontainer unterstützen mehrzeilige Inhalte, wohingegen andere Elementarten, zum Beispiel Texteingabeelemente, nur eine Zeile darstellen können.

 
Beispiel
 
if (document.getElementById("elementID").isMultiLine) {
		    // process the element as a potential multiple-line element
		}
 
Wert

Boolescher Wert: true | false.

 
Standardwert

Standardeinstellung des Elements.

offsetHeight, offsetWidthNN 6 IE 4 DOM nicht zutreffend

Schreibgeschützt

Geben die Höhe und Breite des Elementinhalts zurück, jedoch mit geringfügigen Abweichungen hinsichtlich der Elementrahmen und Auffüllung bei den verschiedenen Betriebssystemversionen von IE und den verschiedenen von der DOCTYPE-Deklaration gesteuerten Kompatibilitätsmodi. Der Trend geht in die Richtung, bei der Berechnung dieser Werte die Rahmen und Auffüllungen, nicht jedoch die Ränder zu berücksichtigen. In Netscape 6 aus praktischen Gründen implementiert, wenngleich nicht Bestandteil des W3C-DOM. Weitere Informationen finden Sie in Abschnitt 9.2 am Anfang dieses Kapitels.

 
Beispiel
 
var midpoint = document.getElementById("elementID").offsetWidth/2;
 
Wert

Pixelwert als ganze Zahl.

 
Standardwert

Elementspezifisch.

offsetLeft, offsetTopNN 6 IE 4 DOM nicht zutreffend

Schreibgeschützt

Geben die linke und obere Koordinaten des Elementrechtecks zurück, jedoch mit geringfügigen Abweichungen hinsichtlich des Koordinatensystemkontexts (gegenüber dem offsetParent-Element) bei den verschiedenen Betriebssystemversionen von IE und den verschiedenen von der DOCTYPE-Deklaration gesteuerten Kompatibilitätsmodi. In Netscape 6 aus praktischen Gründen implementiert, wenngleich nicht Bestandteil des W3C-DOM. Weitere Informationen finden Sie in Abschnitt 9.2 am Anfang dieses Kapitels. Bei positionierten Elementen sollten Sie sich besser auf die style-Eigenschaften des Elements verlassen, die die Position im Dokument- oder Ansichtsbereich des Browsers steuern.

 
Beispiel
 
if (document.getElementById("elementID").offsetLeft <= 20 &&
		document.getElementById("elementID").offsetTop <=40) {
		    ...
		}
 
Wert

Pixelwert als ganze Zahl.

 
Standardwert

Elementspezifisch.

offsetParentNN 6 IE 4 DOM nicht zutreffend

Schreibgeschützt

Gibt eine Referenz auf das Objekt zurück, das als Positionierungskontext für den Offset des aktuellen Elements dient. Bei den meisten Elementen in einer IE-Seite und allen Elementen in einer Netscape-6-Seite handelt es sich hierbei um das body-Objekt. Elemente in IE, die in div-Elementen verpackt sind oder Zellen einer Tabelle darstellen, weisen jedoch andere Parent-Objekte auf. Bei komplex verschachtelten Elementen kann diese Eigenschaft je nach Browserversion die unterschiedlichsten Objekte zurückgeben. Die Eigenschaft offsetParent eines td-Elements ist in IE 4 für Windows beispielsweise das nächstäußere tr-Element, in neueren Versionen von IE für Windows und in allen Versionen von IE für den Macintosh hingegen das table-Element. Netscape 6 hingegen betrachtet nach wie vor das body-Element als offsetParent des td-Elements. Ein Beispiel für die Verwendung dieser Eigenschaft zur Berechnung der genauen Position eines Inline-Elements finden Sie in Abschnitt 9.2 am Anfang dieses Kapitels.

 
Beispiel
 
var containerLeft = document.getElementById("elementID")offsetParent.offsetLeft;
 
Wert

Objektreferenz.

 
Standardwert

body-Objekt.

outerHTMLNN nicht zutreffend IE 4 DOM nicht zutreffend

Lesen/Schreiben

Gibt den dargestellten Text und die HTML-Tags (also den gesamten Quellcode) einschließlich des Start- und dem End-Tags des aktuellen Elements an. Wenn Sie nur auf den dargestellten Text zugreifen möchten, verwenden Sie die Eigenschaft outerText. Den Quellcode ohne die Tags des aktuellen Elements finden Sie mit der Eigenschaft innerHTML. Änderungen an dieser Eigenschaft, die die HTML-Tags betreffen, werden vom HTML-Parser so wiedergegeben, als ob der neue Wert im ursprünglichen Quellcode enthalten sei. Sie können diese Eigenschaft erst ändern, nachdem das Dokument vollständig geladen wurde, dann jedoch haben Sie sogar die Möglichkeit, den Elementtyp zu ändern oder das Element selbst durch reine Textinhalte zu ersetzen. Änderungen an der Eigenschaft outerHTML werden im Quellcode nicht widergespiegelt, wenn Sie die Quelle im Browser anzeigen. Informationen zum Hinzufügen von Inhalten zu vorhandenem HTML-Code finden Sie in der Abhandlung der Methode insertAdjacentHTML( ). In IE 4 für den Macintosh wird diese Eigenschaft bei vielen Objekten nicht unterstützt. Das W3C-DOM-Äquivalent erfordert eine umfassende Manipulation der Nodelevel-Objekte (siehe Kapitel 5).

 
Beispiel
 
document.getElementById("elementID").outerHTML =
		    "<acronym id="quotes">NI<i>M</i>BY</acronym>";
 
Wert

Zeichenfolge mit oder ohne HTML-Tags.

 
Standardwert

Leere Zeichenfolge.

outerTextNN nicht zutreffend IE 4 DOM nicht zutreffend

Lesen/Schreiben

Gibt den dargestellten Text (nicht jedoch die Tags) des aktuellen Elements an. Wenn Sie auf den dargestellten Text einschließlich aller HTML-Tags des Elements zugreifen möchten, verwenden Sie die Eigenschaft outerHTML. Änderungen an dieser Eigenschaft werden vom HTML-Parser nicht wiedergegeben, d. h. HTML-Tags, die Sie hinzufügen, werden lediglich als darstellbare Textinhalte behandelt. Sie können diese Eigenschaft erst ändern, nachdem das Dokument vollständig geladen wurde. Änderungen an der Eigenschaft outerText werden im Quellcode nicht widergespiegelt, wenn Sie die Quelle im Browser anzeigen. In IE 4 für den Macintosh wird diese Eigenschaft bei vielen Objekten nicht unterstützt.

 
Beispiel
 
document.getElementById("elementID").outerText = "UNESCO";
 
Wert

Zeichenfolge.

 
Standardwert

Leere Zeichenfolge.

parentElementNN nicht zutreffend IE 4 DOM nicht zutreffend

Schreibgeschützt

Gibt eine Referenz auf das nächstäußere Element in der HTML-Containment-Hierarchie zurück. Das HTML-Parent-Objekt ist nicht notwendigerweise dasselbe Objekt wie das, das von der Eigenschaft offsetParent zurückgegeben wird. Das parentElement ist strikt auf den enthaltenen Quellcode beschränkt, während sich die Eigenschaft offsetParent auf das nächstäußere Element bezieht, das als Koordinatensystem für die Bestimmung der Position des aktuellen Elements verwendet wird. Wenn beispielsweise das Hauptdokument ein p-Element enthält, in dem wiederum ein em-Element verschachtelt ist, weist das em-Element zwei Parent-Objekte auf. Die Eigenschaft parentElement gibt das p-Element zurück (weil sich der HTML-Quellcode im Code dieses Elements befindet), die Eigenschaft offsetParent hingegen das body-Element (weil das Element in dessen Koordinatenraum angezeigt wird).

 

Mithilfe kaskadierender parentElement-Eigenschaften können Sie problemlos mehrere Parent-Ebenen überspringen:

 

Anschließend können Sie mithilfe von Referenzen auf die Eigenschaften oder Methoden eines Parent-Elements zugreifen.

 

Die entsprechende Eigenschaft im W3C-DOM ist parentNode.

 
Beispiel
 
document.getElementById("elementID").parentElement.style.fontSize = "14pt";
 
Wert

Elementobjektreferenz.

 
Standardwert

Elementspezifisch.

scopeName, tagUrnNN nicht zutreffend IE 5(Win) DOM nicht zutreffend

Schreibgeschützt

Bei benutzerdefinierten Elementen, die auf XML-Namespaces basieren, gibt die Eigenschaft scopeName den Bezeichner zurück, der den Tag-Namen mit einem an anderer Stelle im Dokument über das Attribut xmlns definierten Namespace verknüpft. Alle reinen HTML-Elemente geben für diese Eigenschaft den Wert HTML zurück. Die Eigenschaft tagUrn gibt die URI des eingestellten Namespace zurück. Die entsprechenden Eigenschaften im W3C-DOM sind prefix und namespaceURI.

 
Beispiel
 
var allTitles = document.getElementsByTagName("title");
		for (var i = 0; i < allTitles.length; i++) {
		    if (allTitles[i].scopeName == "libBook" &&
		        allTitles[i].tagUrn.indexOf("catalog.umv.edu") != -1) {
		        // process title elements from the desired namespace here
		    }
		}
 
Wert

Zeichenfolgen.

 
Standardwert

HTML für scopeName; leere Zeichenfolge für tagUrn.

sourceIndexNN nicht zutreffend IE 4 DOM nicht zutreffend

Schreibgeschützt

Gibt den auf Null basierenden Index des Elements unter allen Elementen im Dokument zurück. Elemente sind entsprechend ihrer Quellcodereihenfolge nummeriert, wobei das erste Element den sourceIndex-Wert Null aufweist.

 
Beispiel
 
var whichElement = document.getElementById("elementID").sourceIndex;
 
Wert

Eine positive ganze Zahl oder Null.

 
Standardwert

Elementspezifisch.

tagNameNN 6 IE 4 DOM 1

Schreibgeschützt

Gibt den Namen des Tags des aktuellen Elements zurück. Tag-Namen werden für Zeichenfolgenvergleiche unabhängig vom Quellcodestil oder der DOCTYPE-Deklaration stets in Großbuchstaben zurückgegeben.

 
Beispiel
 
var theTag = document.getElementById("elementID").tagName;
 
Wert

Zeichenfolge.

 
Standardwert

Elementspezifisch.

uniqueIDNN nicht zutreffend IE 5(Win) DOM nicht zutreffend

Schreibgeschützt

Gibt eine Zeichenfolge mit einem Bezeichner zurück, der sich von den Bezeichnern aller anderen Objekte in der Seite unterscheidet. Wird hauptsächlich dazu verwendet, einem neu erstellten Element eine ID zuzuweisen, wenn der Browser den Namen nach seinem eigenen Benennungsschema selbst vergeben kann. Wird im Allgemeinen als Eigenschaft des document-Objekts verwendet, kann jedoch auch über eine beliebige vorhandene Elementobjektreferenz aufgerufen werden. Der Bezeichner erfüllt alle Voraussetzungen für den Einsatz als Parameterzeichenfolge in Methoden, die eine Element-ID erfordern.

 
Beispiel
 
var newElem = document.createElement("p");
		newElem.id = document.uniqueID;
 
Wert

Zeichenfolge.

 
Standardwert

Vom Browser erzeugt.

addBehavior( )NN nicht zutreffend IE 5(Win) DOM nicht zutreffend

addBehavior("URL")

Bringt ein internes oder externes IE-Verhalten am aktuellen Element an. Nachdem ein Skript das Verhalten angebracht hat, reagiert das Element auf Ereignisse, die (sofern vorhanden) für das Verhalten definiert wurden, und ermöglicht den Zugriff auf die dem Verhalten zugeordneten Eigenschaften und Methoden. Eine externe Verhaltensdatei muss von derselben Domäne (und mit demselben Protokoll) bereitgestellt werden wie die aktuelle Seite. Weitere Informationen zum Anwenden von IE/Windows-Verhalten finden Sie unter http://msdn.microsoft.com/workshop/author/behaviors/overview.asp.

 
Parameter
 
  • Bei externen Verhalten eine relative oder absolute URL der .htc-Datei auf dem Server. Bei internen Verhalten ein spezielles Format, das im nächsten Abschnitt beschrieben wird.
 
Zurückgegebener Wert

Ganzzahlige laufende Nummer, die als Parameter für die Methode removeBehavior( ) verwendet werden kann.

applyElement( )NN nicht zutreffend IE 5(Win) DOM nicht zutreffend

applyElement(elementObject[, type])

Fügt ein neues Element je nach dem Wert des zweiten Parameters entweder als Child-Element oder als neues Parent-Objekt des aktuellen Objekts in den Dokumentbaum ein. Standardmäßig wird das aktuelle Objekt in das neue Element gepackt. Sie können das neue Element jedoch auch als Child-Element einfügen. In diesem Fall wird das neue Element, wenn sich das aktuelle Objekt im Dokumentbaum befindet (also nicht mit der Methode document.createElement( ) erstellt wurde und seither frei im Speicher schwebt) und bereits verschachtelte Child-Elemente enthält, so eingefügt, dass die bisherigen Child-Elemente des aktuellen Elements zu Child-Elementen des eingefügten Elements werden. Dieses Wrapping-Verhalten ist einzigartig unter den IE-Elementeinfügemethoden und kann weit reichende Veränderungen im Dokumentbaum bewirken. Mit Vorsicht zu verwenden.

 
Parameter
 
  • Referenz auf ein dynamisch erzeugtes oder vorhandenes Elementobjekt im Dokumentbaum.
  • Optionaler Zeichenfolgenwert: inside (das neue Element wird zum einzigen, ersten Child-Element des aktuellen Objekts); outside (das neue Element wird zum Parent des aktuellen Objekts). Der Standardwert ist outside.
 
Zurückgegebener Wert

Referenz auf das neu hinzugefügte Elementobjekt.

clearAttributes( )NN nicht zutreffend IE 5(Win) DOM nicht zutreffend

Entfernt alle Attribute des aktuellen Elements mit Ausnahme der Attribute id und name (sofern angegeben). Dadurch zeigt das Element auch keine Darstellungsmerkmale mehr, die von den entfernten Attributen abhängig sind.

 
Parameter

Keine.

 
Zurückgegebener Wert

Keiner.

click( )NN 2 IE 4 DOM 1

Simuliert einen Mausklick auf das Element und löst in Internet Explorer ab Version 4 und Navigator ab Version 4 ein onclick-Ereignis aus. Beachten Sie, dass in Browsern vor IE 4 und Netscape 6 nicht alle Elemente die click( )-Methode (bzw. das onclick-Ereignis) verarbeiten können. Außerdem können Sie nicht davon ausgehen, dass alle Elemente, deren Aussehen sich ändert, wenn sie vom Benutzer angeklickt werden, bei einem durch ein Skript ausgelösten Klickereignis dasselbe Verhalten zeigen. In einigen Macintosh-Browserversionen wird ein Kontrollkästchen beispielsweise nicht markiert dargestellt, wenn ein Skript seine click( )-Methode aufruft. In diesem Fall sollten Sie die click( )-Methode nur aufrufen, wenn eine onclick-Ereignisbehandlungsroutine einen Code ausführt, und zusätzlich die Eigenschaft checked des Kontrollkästchens auf den gewünschten Wert setzen.

 
Parameter

Keine.

 
Zurückgegebener Wert

Keiner.

getAttribute( )NN 6 IE 4 DOM 1

getAttribute(attributeName) getAttribute(attributeName[,caseSensitivity])

Gibt den Wert des benannten Attributs innerhalb des aktuellen Elements zurück. Wenn das Attribut im Objektmodell als Eigenschaft widergespiegelt wird, gibt diese Methode denselben Wert zurück wie das Auslesen der entsprechenden Eigenschaft des Objekts. Hierbei handelt es sich um die laut W3C-DOM bevorzugte Methode zum Lesen eines Objektattributwerts (also eines Eigenschaftswerts).

 

Bei dem Attributnamen, den Sie als Parameter übergeben, spielt die Groß- und Kleinschreibung in den aktuellen Browsern keine Rolle. IE stellt allerdings einen optionalen zweiten Parameter bereit, mit dem Sie die Berücksichtigung der Groß-/Kleinschreibung in Attributnamen erzwingen können. Dies könnte dazu verleiten, Attributnamen in unterschiedlicher Schreibweise mehrmals zu verwenden – eine Praxis, von der dringend abgeraten wird.

 

Informationen zum Zuweisen von Werten zu Attributen und zum Erstellen neuer Attribut-/Wertpaare finden Sie in der Abhandlung der Methode setAttribute( ).

 
Parameter
 
  • Der im HTML-Tag verwendete Attributname (ohne das Gleichheitszeichen (=). Die Groß-/Kleinschreibung ist standardmäßig unwichtig. Während Sie in IE die Berücksichtigung der Groß-/Kleinschreibung erzwingen können, spielt die Schreibweise bei Netscape 6 keine Rolle. Angesichts des derzeitigen Trends, verstärkt mit XHTML zu arbeiten, wo die Groß-/Kleinschreibung eine Rolle spielt, ist es jedoch wahrscheinlich am besten, grundsätzlich auf die Groß-/Kleinschreibung zu achten.
  • Ein optionaler ganzzahliger Wert (nur IE). Der Standardwert ist 0 (Groß-/Kleinschreibung unwichtig). Der Wert 1 bewirkt, dass der Wert des Parameters attributeName nur dann zurückgegeben wird, wenn die Schreibweise des Attributs im HTML-Tag mit der des Parameters genau übereinstimmt.
 
Zurückgegebener Wert

Das W3C-DOM und Netscape 6 verwalten Attributwerte ausschließlich als Zeichenfolgendatentypen (Strings). IE hingegen kann einen Attributwert in Form einer Zeichenfolge, eines Zahlenwerts oder eines Booleschen Werts zurückgeben.

getAttributeNode( )NN 6 IE 6 DOM 1

getAttributeNode(attributeName)

Gibt eine Referenz auf die mit dem Namen verknüpfte Attributnode (Attr-Objekt) zurück. Diese Node weist denselben Nodetyp auf wie die Nodes in dem von der Eigenschaft attributes eines Elements zurückgegebenen Array, mithilfe der Methode getAttributeNode( ) können Sie jedoch direkt über den Namen auf das Attr-Nodeobjekt zugreifen. Dies ist vor allem bei XML-Dokumenten sinnvoll, in denen ein Attribut wichtige Daten zu dem jeweiligen Element übermitteln kann. Weitere Informationen zu diesem Nodetyp finden Sie in der Abhandlung des Attr-Objekts.

 
Parameter
 
  • Der im Tag verwendete Attributname (ohne das Gleichheitszeichen (=). Die Groß- und Kleinschreibung spielt weder IE noch in Navigator eine Rolle. Angesichts des derzeitigen Trends, verstärkt mit XHTML zu arbeiten, wo die Groß-/Kleinschreibung eine Rolle spielt, ist es jedoch wahrscheinlich am besten, grundsätzlich auf die Groß-/Kleinschreibung zu achten.
 
Zurückgegebener Wert

Referenz auf ein Attr-Objekt.

getAttributeNS( )NN 6 IE nicht zutreffend DOM 2

getAttributeNS("namespaceURI", "localName")

Gibt den Wert des lokal benannten Attributs mit einer übereinstimmenden Namespace-URI innerhalb des aktuellen Elements zurück. Diese Methode funktioniert wie die Methode getAttribute( ), eignet sich jedoch auch für Attribute in XML-Dokumenten, die entsprechend einer Namespace-Spezifikation bezeichnet sind. Das folgende einfache XML-Dokument verwendet einen Namespace für ein Attribut des Elements libBook:title:

 

Zum Abrufen des Werts des Attributs libBook:rareBooks würde die Methode für das Element den getAttributeNS( )-Methodenaufruf mit dem folgenden Parameter enthalten:

 
Parameter
 
  • URI-Zeichenfolge, die einer URI entspricht, welche weiter vorne im Dokument einer Beschriftung zugewiesen wurde.
  • Der lokale Namensteil des Attributs.
 
Zurückgegebener Wert

Das W3C-DOM und Netscape 6 verwalten Attributwerte ausschließlich als Zeichenfolgendatentypen (Strings).

getElementsByTagName( )NN 6 IE 5 DOM 1

getElementsByTagName("tagName")

Gibt ein Array aller untergeordneten Elemente des aktuellen Elements zurück, deren Tag-Namen mit dem Parameter der Methode übereinstimmen. Das Array enthält alle Child-Elemente der verschiedenen Ebenen in ihrer Quellcodereihenfolge. Das aktuelle Element ist in dem Array nicht enthalten. Wenn keine Übereinstimmungen vorhanden sind, weist das Array eine Länge von Null auf.

 

Bei Netscape 6, IE 5/Macintosh und IE 6/Windows können Sie ein Platzhalterzeichen (Sternchen in Anführungszeichen) im Parameter übergeben, um ein Array aller untergeordneten Elemente ungeachtet des Tag-Namens zurückzugeben. Beachten Sie jedoch, dass die geringfügigen Unterschiede in den Dokumentbaumstrukturen der verschiedenen Browser dazu führen können, dass unterschiedlich lange Arrays zurückgegeben werden, wenn Sie ein Platzhalterzeichen als Parameter verwenden.

 
Parameter
 
  • Der Tag-Name des gewünschten Elements (Groß-/Kleinschreibung standardmäßig irrelevant) oder ein Sternchen als Platzhalter für alle Tag-Namen.
 
Zurückgegebener Wert

Array mit null oder mehr Elementreferenzen.

BREAKFILE
getElementsByTagNameNS( )NN 6 IE nicht zutreffend DOM 2

getElementsByTagNameNS("namespaceURI", "localName")

Gibt ein Array aller untergeordneten Elemente des aktuellen Elements zurück, deren lokale Namen mit dem zweiten und deren (an anderer Stelle im Dokument in Form einer Namespace-Deklaration zugewiesene) Namespace-URIs mit dem ersten Parameter der Methode übereinstimmen. Das Array enthält alle Child-Elemente der verschiedenen Ebenen in ihrer Quellcodereihenfolge. Das aktuelle Element ist in dem Array nicht enthalten. Wenn keine Übereinstimmungen vorhanden sind, weist das Array eine Länge von Null auf. Hauptsächlich auf XML-Dokumente anwendbar.

 
Parameter
 
  • URI-Zeichenfolge, die einer URI entspricht, welche weiter vorne im Dokument einer Beschriftung zugewiesen wurde.
  • Der lokale Namensteil des Tag-Namens.
 
Zurückgegebener Wert

Array mit null oder mehr Elementreferenzen.

hasAttribute( )NN 6 IE nicht zutreffend DOM 1

hasAttribute("attributeName")

Gibt den Booleschen Wert true zurück, wenn das aktuelle Element ein Attribut aufweist, dessen Name mit dem Parameter der Methode übereinstimmt.

 
Parameter
 
  • Der Name des gesuchten Attributs (Groß-/Kleinschreibung beachten).
 
Zurückgegebener Wert

Boolescher Wert: true | false.

hasAttributeNS( )NN 6 IE nicht zutreffend DOM 2

hasAttributeNS("namespaceURI", "localName")

Gibt den Booleschen Wert true zurück, wenn das aktuelle Element ein Attribut aufweist, dessen lokaler Name mit dem zweiten und dessen (an anderer Stelle im Dokument in Form einer Namespace-Deklaration zugewiesenen) Namespace-URI mit dem ersten Parameter der Methode übereinstimmt.

 
Parameter
 
  • URI-Zeichenfolge, die einer URI entspricht, welche weiter vorne im Dokument einer Beschriftung zugewiesen wurde.
  • Der lokale Namensteil des Attributnamens.
 
Zurückgegebener Wert

Boolescher Wert: true | false.

insertAdjacentElement( )NN nicht zutreffend IE 5(Win) DOM nicht zutreffend

insertAdjacentElement("where", elementObjectReference)

Fügt ein Elementobjekt an der angegebenen Position relativ zum aktuellen Element ein. In der Regel wird das einzufügende Elementobjekt separat erstellt (z. B. mit der Methode document.createElement( )) oder in Form einer Referenz auf ein bereits im Dokumentbaum vorhandenes Objekt eingebunden, in welchem Fall das Objekt selbst mit der Methode insertAdjacentElement( ) an die neue Position verschoben wird.

 

Die Zielposition wird durch das erste Attribut anhand eines der vier folgenden Parameterwerte festgelegt:

 

Die Auswirkungen auf den Elementbaum des Dokuments sind wohl definiert, die Ergebnisse variieren in der Darstellung jedoch je nachdem, ob es sich bei dem aktuellen und/oder dem eingefügten Element um ein Inline- oder ein Blockelement handelt. Ein eingefügtes Blockelement (z. B. ein div- oder ein p-Element) wird in der jeweils nächsten Zeile am linken Rand des Blockpositionierungskontexts (z. B. des body- oder des td-Elements) ausgerichtet. Auf ein Element angewendet entspricht die W3C-DOM-Methode appendChild( ) der Methode insertAdjacentElement( ) mit dem Positionsparameter beforeEnd.

 
PositionEinfügepunkt
BeforeBeginVor dem Start-Tag des aktuellen Elements als vorhergehendes gleichrangiges Element
AfterBeginUnmittelbar nach dem Start-Tag des aktuellen Elements als erstes Child-Objekt
BeforeEndUnmittelbar vor dem End-Tag des aktuellen Elements als letztes Child-Objekt
AfterEndNach dem End-Tag des aktuellen Elements als nachfolgendes gleichrangiges Element
 
Parameter
 
  • Zeichenfolge mit einer der folgenden Konstanten (Groß-/Kleinschreibung unwichtig): BeforeBegin | AfterBegin | BeforeEnd | AfterEnd. Die erste und letzte Position liegt außerhalb der HTML-Tags des aktuellen Elements, die zweite und dritte Position zwischen den Tags und dem Elementinhalt.
  • Referenz auf ein beliebiges gültiges Elementobjekt, das entweder bereits im Dokumentbaum vorhanden ist oder dynamisch erstellt wird.
 
Zurückgegebener Wert

Referenz auf das eingefügte Elementobjekt.

insertAdjacentHTML( )NN nicht zutreffend IE 4 DOM nicht zutreffend

insertAdjacentHTML("where", HTMLText)

Fügt eine Textzeichenfolge an der angegebenen Position relativ zum vorhandenen HTML-Inhalt des Elements ein. Wenn der einzufügende Text HTML-Tags enthält, wertet der Browser die Tags aus und stellt den Text in der entsprechenden Weise dar. In IE 4 für den Macintosh wird diese Methode bei vielen Objekten nicht unterstützt.

 
Parameter
 
  • Zeichenfolge mit einer der folgenden Konstanten: BeforeBegin | AfterBegin | BeforeEnd | AfterEnd. Die erste und letzte Position liegt außerhalb der HTML-Tags des aktuellen Elements, die zweite und dritte Position zwischen den Tags und dem Elementinhalt.
  • Zeichenfolge mit dem Text- und/oder HTML-Inhalt, der an der gewünschten Position eingefügt werden soll.
 
Zurückgegebener Wert

Keiner.

insertAdjacentText( )NN nicht zutreffend IE 4 DOM nicht zutreffend

insertAdjacentText("where", text)

Fügt einen Text an der angegebenen Position relativ zum vorhandenen HTML-Inhalt des Elements ein. Wenn der einzufügende Text HTML-Tags enthält, werden diese als Zeichenfolgen in der Seite dargestellt. In IE 4 für den Macintosh wird diese Methode bei vielen Objekten nicht unterstützt.

 
Parameter
 
  • Zeichenfolge mit einer der folgenden Konstanten: BeforeBegin | AfterBegin | BeforeEnd | AfterEnd. Die erste und letzte Position liegt außerhalb der HTML-Tags des aktuellen Elements, die zweite und dritte Position zwischen den Tags und dem Elementinhalt.
  • Zeichenfolge mit dem Textinhalt, der an der gewünschten Position eingefügt werden soll.
 
Zurückgegebener Wert

Keiner.

mergeAttributes( )NN nicht zutreffend IE 5(Win) DOM nicht zutreffend

mergeAttributes(modelElementReference[, preserveIDs])

Kopiert Attributnamens-/Wertpaare aus dem durch den Parameter angegebenen Element in das aktuelle Element. Dies ist besonders hilfreich, wenn sie umfangreiche Attributsätze aus einem vorhandenen in ein neu erstelltes Element übernehmen möchten. Standardmäßig werden beim Kopieren die Attribute id und name nicht berücksichtigt, sodass die für die Skripterstellung und die Arbeit mit Formularen erforderliche Eindeutigkeit der Bezeichner gewahrt bleibt. In IE für Windows ab Version 5.5 steht ein optionaler zweiter Boolescher Parameter zur Verfügung, der, wenn er auf false gesetzt ist, bewirkt, dass auch die Attribute id und name dupliziert werden.

 
Parameter
 
  • Referenz auf ein vorhandenes Element, dessen Attributnamens-/Wertpaare in das aktuelle Element kopiert werden sollen.
  • Optional ein Boolescher Wert: Der Wert false bewirkt, dass die Attribute id und name nicht aus dem Vorlagenelement in das aktuelle Element kopiert werden. Der Standardwert für diesen Parameter lautet true.
 
Zurückgegebener Wert

Keiner.

removeAttribute( )NN 6 IE 4 DOM 1

removeAttribute("attributeName") removeAttribute("attributeName"[, caseSensitivity])

Entfernt das benannte Attribut aus dem aktuellen Element. Eine IE-4-Anforderung, laut der nur solche Attribute entfernt werden konnten, die mit der Methode setAttribute( ) hinzugefügt worden waren, ist in IE ab Version 5 und Netscape 6 nicht mehr in Kraft. Beim Entfernen eines Attributs sind im Quellcode keine Änderungen zu sehen, wenn dieser im Browser eingeblendet wird, doch auf die Darstellung des Elements in Browser ergeben sich sehr wohl Auswirkungen. Der Attributwert und die Node sind nach dem Entfernen ebenfalls nicht mehr verfügbar.

 
Parameter
 
  • Der im HTML-Tag verwendete Attributname (ohne das Gleichheitszeichen (=). Die Groß-/Kleinschreibung ist standardmäßig unwichtig. Während Sie in IE die Berücksichtigung der Groß-/Kleinschreibung erzwingen können, spielt die Schreibweise bei Netscape 6 keine Rolle. Angesichts des derzeitigen Trends, verstärkt mit XHTML zu arbeiten, wo die Groß-/Kleinschreibung eine Rolle spielt, ist es jedoch wahrscheinlich am besten, grundsätzlich auf die Groß-/Kleinschreibung zu achten.
  • Ein optionaler ganzzahliger Wert (nur IE). Der Standardwert ist 0 (Groß-/Kleinschreibung unwichtig). Der Wert 1 bewirkt, dass der Wert des Parameters attributeName nur dann zurückgegeben wird, wenn die Schreibweise des Attributs im HTML-Tag mit der des Parameters genau übereinstimmt.
 
Zurückgegebener Wert

In IE der Boolesche Wert true (erfolgreich) oder false (Attribut existiert nicht). Netscape 6 gibt (entsprechend der W3C-DOM-Spezifikation) keinen Wert zurück.

removeAttributeNode( )NN 6 IE 6 DOM 1

removeAttributeNode(attrObjectReference)

Entfernt das Attribut aus dem durch die Parameterreferenz auf ein vorhandenes Attr-Nodeobjekt angegebenen aktuellen Element. Dies stellt eine alternative Möglichkeit dar, ein Attribut aus einem Element zu entfernen, wenn das Skript nur über eine Referenz auf das Attr-Nodeobjekt, nicht aber über seinen Namen verfügt. Beim Entfernen einer Attributnode sind im Quellcode keine Änderungen zu sehen, wenn dieser im Browser eingeblendet wird, doch auf die Darstellung des Elements in Browser ergeben sich sehr wohl Auswirkungen. Der Attributwert und die Node sind nach dem Entfernen nicht mehr verfügbar.

 
Parameter
 
  • Eine Referenz auf ein dem aktuellen Element zugewiesenes Attr-Nodeobjekt.
 
Zurückgegebener Wert

Referenz auf das entfernte Attr-Objekt, das nicht mehr im Dokumentbaum enthalten ist, aber an anderer Stelle wieder eingefügt werden kann.

removeAttributeNS( )NN 6 IE nicht zutreffend DOM 2

removeAttributeNS("namespaceURI", "localName")

Entfernt das lokal benannte Attribut mit einer übereinstimmenden Namespace-URI aus dem aktuellen Element. Diese Methode funktioniert wie die Methode removeAttribute( ), eignet sich jedoch auch für Attribute in XML-Dokumenten, die entsprechend einer Namespace-Spezifikation bezeichnet sind. Das folgende einfache XML-Dokument verwendet einen Namespace für ein Attribut des Elements libBook:title:

 

Zum Entfernen des Werts des Attributs libBook:rareBooks würde die Methode für das Element den removeAttributeNS( )-Methodenaufruf mit dem folgenden Parameter enthalten:

 
Parameter
 
  • URI-Zeichenfolge, die einer URI entspricht, welche weiter vorne im Dokument einer Beschriftung zugewiesen wurde.
  • Der lokale Namensteil des Attributs.
 
Zurückgegebener Wert

Keiner.

removeBehavior( )NN nicht zutreffend IE 5(Win) DOM nicht zutreffend

removeBehavior(behaviorID)

Löst die Verknüpfung zwischen dem aktuellen Element und einem Verhalten auf, die zuvor mit der Methode addBehavior( ) eingerichtet wurde. Der Parameter ist der von der Methode addBehavior( ) zurückgegebene Wert, den Sie bis zum Aufruf der zweiten Methode in einer Variablen speichern müssen.

 
Parameter
 
  • Ganzzahlige laufende Nummer, die von der Methode addBehavior( ) für das aktuelle Element und den aktuellen Verhaltenstyp erzeugt wurde.
 
Zurückgegebener Wert

Boolescher Wert true (erfolgreich entfernt) oder false.

scrollIntoView( )NN 7 IE 4 DOM nicht zutreffend

scrollIntoView([showAtTop])

Rollt das aktuelle Element in den sichtbaren Anzeigebereich des Browsers. Standardmäßig wird der Bildlauf so durchgeführt, dass sich der obere Rand des Elements am oberen Rand des Bildlaufbereichs befindet. Sie können das Element jedoch auch am unteren Rand des Bildlaufbereichs ausrichten.

 
Parameter
 
  • Optional ein Boolescher Wert: true (Standardwert) bewirkt, dass sich der obere Rand des Inhalts am oberen Rand des Bildlaufbereichs befindet. false bewirkt, dass der untere Rand des Inhalts am unteren Rand des Bildlaufbereichs positioniert wird.
 
Zurückgegebener Wert

Keiner.

setActive( )NN nicht zutreffend IE 5.5(Win) DOM nicht zutreffend

Macht das aktuelle Element zum aktiven Element, ohne es in den sichtbaren Anzeigebereich des Browsers zu rollen. Außerdem bewirkt die Methode keinen Wechsel des Fokus zwischen verschiedenen Fenstern oder Frames, wenn sie über Fensterobjektbereiche hinweg aufgerufen wird. Das Element empfängt jedoch ein onfocus-Ereignis, wenn die Methode aufgerufen wird.

 
Parameter

Keine.

 
Zurückgegebener Wert

Keiner.

setAttribute( )NN 6 IE 4 DOM 1

setAttribute("attributeName", value) setAttribute("attributeName", value[, caseSensitivity])

Legt den Wert des benannten Attributs innerhalb des aktuellen Elements fest. Wenn das Attribut im Objektmodell als Eigenschaft widergespiegelt wird, hat diese Methode denselben Effekt wie das Zuweisen eines Werts zur Eigenschaft des Objekts. Dennoch ist die Methode setAttribute( ) laut W3C-DOM die bevorzugte Methode zum Einstellen (und die Methode getAttribute( ) die bevorzugte Methode zum Auslesen) eines Attributwerts.

 

Wenn das Attribut noch nicht im Element vorhanden ist, fügt ihm die Methode setAttribute( ) das Attribut als Namens-/Wertpaar hinzu (außer in IE 4 bis 5.5 wird das neu hinzugefügte Attribut nicht als Teil der attributes-Sammlung des Elements zurückgegeben).

 

IE behandelt die Attributnamen mehr wie Objekteigenschaftsnamen. Wenn also eine Diskrepanz zwischen dem Attribut und dem entsprechenden Eigenschaftsnamen vorliegt (z. B. class und className), erfordert IE daher die Version mit dem Eigenschaftsnamen. Wenn Sie dem Attribut class eines Elements sowohl für IE als auch für Navigator einen neuen Wert zuweisen möchten, sollten Sie im Code eine Verzweigung einrichten und die Methode für jeden Browser nur ein Mal aufrufen, damit dem Navigator-Element kein ungenutztes className-Attribut hinzugefügt wird. Zum Zwecke der Objekterkennung gibt ein Browser, der den W3C-DOM-Ansatz unterstützt, einen Zeichenfolgenwert für die Methode getAttribute("class") des Elements zurück.

 

Einem Attribut können für Netscape 6 (entsprechend der W3C-DOM-Spezifikation) nur Zeichenfolgenwerte zugeordnet werden. IE unterstützt auch andere Datentypen (wie Number und Boolean), doch wenn Sie beispielsweise einen numerischen Wert in Form einer Zeichenfolge zuweisen, wird der Datentyp umgewandelt, sodass die Methode getAttribute( ) den Wert in dem von IE bevorzugten Datentyp zurückgibt. In Netscape 6 sind alle Attributwerte Zeichenfolgen.

 

Attributnamen sind in Netscape 6 nicht von der Groß- und Kleinschreibung abhängig, Sie sollten sich jedoch angewöhnen, Attributnamen in Anlehnung an XHTML grundsätzlich in Kleinbuchstaben zu schreiben. IE berücksichtigt bei dieser Methode standardmäßig die Groß-/Kleinschreibung der Attributnamen. Mit einem optionalen dritten Parameter können Sie allerdings auch selbst angeben, ob die Groß-/Kleinschreibung des Attributnamens berücksichtigt werden soll. Es wird dringend empfohlen, die Berücksichtigung der Groß- und Kleinschreibung bei Attributnamen nicht zu missbrauchen, um gleich lautende Attributnamen zuweisen, die sich lediglich in ihrer Schreibweise unterscheiden. Wenn Sie in Ihrem Code Attributnamen durchgängig in Kleinbuchstaben schreiben, können Sie den dritten IE-Parameter weglassen und bleiben in vollem Umfang W3C-DOM-konform.

 
Parameter
 
  • Der im HTML-Tag verwendete Attributname (siehe oben stehender Hinweis zu IE).
  • Für Netscape 6 der Attributwert in Form einer Zeichenfolge. Für IE der Attributwert in Form einer Zeichenfolge, einer Zahl oder eines Booleschen Werts, entsprechend dem Datentyp des Attributs. Es können auch alle Werte als Zeichenfolgen angegeben werden, wobei IE die Datentypen intern je nach Bedarf konvertiert.
  • Ein optionaler ganzzahliger Wert (nur IE). Der Wert 1 (Standardwert) bewirkt, dass der Wert des Parameters attributeName nur dann gesetzt wird, wenn die Schreibweise des Attributs im HTML-Tag mit der des Parameters genau übereinstimmt, was die Verwendung gleich lautender Attributnamen in unterschiedlicher Groß-/Kleinschreibweise ermöglicht. Der Wert 0 bewirkt, dass der Wert des Parameters attributeName ungeachtet der Groß-/Kleinschreibung automatisch an den Wert des ersten Attributs angeglichen wird.
 
Zurückgegebener Wert

Keiner.

setAttributeNode( )NN 6 IE 6 DOM 1

setAttributeNode(attrObjectReference)

Fügt ein Attribut in das aktuelle Element ein oder ersetzt ein vorhandenes Attribut. Der Parameter ist eine Referenz auf ein Attr-Nodeobjekt, das entweder neu erstellt oder seinerseits ein anderes Element im Dokumentbaum referenziert. Beim Aufruf der Methode setAttributeNode( ) sucht der Browser zunächst nach einer Übereinstimmung zwischen dem Namen des neuen Attributs und einem vorhandenen Attributnamen. Wenn eine Übereinstimmung gefunden wird, ersetzt das neue Attribut das ursprüngliche Attribut, andernfalls wird das neue Attribut den Attributen des Elements hinzugefügt. Beim Hinzufügen einer Attributnode sind im Quellcode keine Änderungen zu sehen, wenn dieser im Browser eingeblendet wird. Wenn das Attribut die optische Darstellung des Elements beeinflusst, kann sich jedoch die Art und Weise ändern, in der das Element im Browser wiedergegeben wird. Der Wert des neuen Attributs kann mithilfe der Methode getAttribute( ) abgerufen werden.

 
Parameter
 
  • Eine Referenz auf ein Attr-Nodeobjekt, das mithilfe der Methode document.createAttribute( ) erstellt wurde, oder auf eine Attr-Node aus einem anderen Element im Dokumentbaum.
 
Zurückgegebener Wert

Referenz auf ein ersetztes Attr-Objekt, das nicht mehr im Dokumentbaum enthalten ist, oder null, wenn ein neues Attribut hinzugefügt wurde.

setAttributeNodeNS( )NN 6 IE nicht zutreffend DOM 2

setAttributeNodeNS(attrObjectReference)

Fügt ein Attribut in das aktuelle Element ein oder ersetzt ein vorhandenes Attribut. Der Parameter ist eine Referenz auf ein Attr-Nodeobjekt, das entweder neu erstellt oder seinerseits ein anderes Element im Dokumentbaum referenziert. Beim Aufruf der Methode setAttributeNodeNS( ) sucht der Browser zunächst nach einer Übereinstimmung zwischen dem lokalen Namen und der Namespace-URI des neuen Attributs auf der einen und dem lokalen Namen und der Namespace-URI eines vorhandenen Attributs auf der anderen Seite. Wenn eine Übereinstimmung gefunden wird, ersetzt das neue Attribut das ursprüngliche Attribut, andernfalls wird das neue Attribut den Attributen des Elements hinzugefügt. Beim Hinzufügen einer Attributnode sind im Quellcode keine Änderungen zu sehen, wenn dieser im Browser eingeblendet wird. Wenn das Attribut die optische Darstellung des Elements beeinflusst, kann sich jedoch die Art und Weise ändern, in der das Element im Browser wiedergegeben wird. Der Wert des neuen Attributs kann mithilfe der Methode getAttributeNS( ) abgerufen werden.

 
Parameter
 
  • Eine Referenz auf ein Attr-Nodeobjekt, das mithilfe der Methode document.createAttributeNS( ) erstellt wurde, oder auf eine Attr-Node aus einem anderen Element im Dokumentbaum.
 
Zurückgegebener Wert

Referenz auf ein ersetztes Attr-Objekt, das nicht mehr im Dokumentbaum enthalten ist, oder null, wenn ein neues Attribut hinzugefügt wurde.

setAttributeNS( )NN 6 IE nicht zutreffend DOM 2

setAttributeNS("namespaceURI", "qualifiedName", "value")

Fügt ein Attribut in das aktuelle Element ein oder ersetzt ein vorhandenes Attribut. Wenn der qualifizierte Name und die Namespace-URI des als Parameter übergebenen Attributs mit den entsprechenden Werten eines vorhandenen Attributs des Elements übereinstimmt, wird der neue Wert dem vorhandenen Attribut zugewiesen. Falls keine Übereinstimmung vorliegt, wird das Attribut dem Element hinzugefügt.

 
Parameter
 
  • URI-Zeichenfolge, die einer URI entspricht, welche weiter vorne im Dokument einer Beschriftung zugewiesen wurde.
  • Der vollständige Name für das Attribut, bestehend aus dem lokalen Namenspräfix (falls vorhanden), einem Doppelpunkt und dem lokalen Namen.
  • Der Zeichenfolgenwert für das Attribut.
 
Zurückgegebener Wert

Keiner.

BREAKFILE