Element: tagName-Eigenschaft
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since Juli 2015.
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,
tagNameaufgerufen 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 # ref-for-dom-element-tagname① |