Element.tagName

La proprietà tagName di sola lettura dell'interfaccia Element restituisce il nome del tag dell'elemento su cui è chiamato. Ad esempio, se l'elemento è un <img>, la sua proprietà tagName è "IMG" (per i documenti HTML, può essere modificata in modo diverso per i documenti XML/XHTML).

Sintassi

elementName = Element.tagName;

Valore

Una stringa che indica il nome del tag dell'elemento. La capitalizzazione di questa stringa dipende dal tipo di documento:

  • Per gli alberi del DOM che rappresentano documenti HTML, il nome del tag restituito è sempre nel formato maiuscolo canonico. Ad esempio, tagName chiamato su un elemento <div> ritorna "DIV".
  • I nomi dei tag degli elementi in un albero del DOM di XML vengono restituiti nello stesso caso in cui sono scritti nel file XML originale. Se un documento XML include un tag "<SomeTag>", il valore della proprietà tagName è "SomeTag".

Per gli oggetti Element, il valore di tagName è uguale al valore della proprietà nodeName che l'oggetto elemento eredita da Node.

Esempio

HTML

<span id="born">Quando sono nato...</span>

JavaScript

var span = document.getElementById("born");
console.log(span.tagName);

In XHTML (o qualsiasi altro formato XML), il caso originale verrà mantenuto, quindi "span" verrebbe stampato nel caso in cui il nome del tag originale fosse stato creato in minuscolo. In HTML, "SPAN" verrebbe invece stampato indipendentemente dal caso utilizzato durante la creazione del documento originale.

Specifiche

Specifica Stato Commento
DOM
The definition of 'Element: tagName' in that specification.
Living Standard  

Compatibilità con i browser

Update compatibility data on GitHub
DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidFirefox for AndroidOpera for AndroidSafari on iOSSamsung Internet
tagNameChrome Full support 43Edge Full support 12Firefox Full support YesIE Full support YesOpera Full support YesSafari Full support 6WebView Android Full support 43Chrome Android Full support 43Firefox Android Full support YesOpera Android Full support YesSafari iOS Full support YesSamsung Internet Android Full support Yes

Legend

Full support  
Full support