Element: tagName-Eigenschaft
Die tagName
-Eigenschaft des Element
-Interfaces ist eine schreibgeschützte Eigenschaft, die den Tag-Namen des Elements zurückgibt, auf dem sie aufgerufen wird.
Zum Beispiel, wenn das Element ein <img>
ist, dann ist seine tagName
-Eigenschaft IMG
(für HTML-Dokumente; sie kann in XML/XHTML-Dokumenten anders geschrieben sein). Hinweis: Sie können die localName
-Eigenschaft verwenden, um auf den lokalen Namen des Elements zuzugreifen — was in dem Beispiel img
(kleingeschrieben) wäre.
Wert
Ein String, der den Tag-Namen des Elements angibt. Die Groß- und Kleinschreibung dieses Strings hängt vom Dokumententyp ab:
- Für DOM-Bäume, die HTML-Dokumente darstellen, wird der zurückgegebene Tag-Name immer in der kanonischen Großbuchstabenform angezeigt. Zum Beispiel,
tagName
aufgerufen auf einem<div>
element gibt"DIV"
zurück. - Die Tag-Namen von Elementen in einem XML-DOM-Baum werden in der gleichen Schreibweise zurückgegeben, wie sie im ursprünglichen XML-Dokument geschrieben sind. Wenn ein XML-Dokument einen Tag
"<SomeTag>"
enthält, dann ist der Wert dertagName
-Eigenschaft"SomeTag"
.
Für Element
-Objekte ist der Wert von tagName
derselbe wie der Wert der nodeName
-Eigenschaft, die das Elementobjekt von Node
erbt.
Beispiele
HTML
<span id="born">When I was born…</span>
JavaScript
const span = document.getElementById("born");
console.log(span.tagName);
In XHTML (oder jedem anderen XML-Format) wird die ursprüngliche Schreibweise beibehalten, so dass "span"
ausgegeben wird, falls der ursprüngliche Tag-Name in Kleinbuchstaben erstellt wurde. In HTML wird unabhängig von der bei der Erstellung des ursprünglichen Dokuments verwendeten Schreibweise stattdessen "SPAN"
ausgegeben.
Spezifikationen
Specification |
---|
DOM Standard # ref-for-dom-element-tagname① |
Browser-Kompatibilität
BCD tables only load in the browser