element.localName

Obsolète
Cette fonctionnalité est obsolète. Bien qu'encore supportée par des navigateurs, son utilisation est découragée pour tout nouveau projet. Évitez de l'utiliser.

La propriété en lecture seule Node.localName renvoie la partie locale du nom qualifié de ce nœud.

Dans DOM4, cette API a été déplacée de Node vers les interfaces Element et Attr.

Syntaxe

name = element.localName

name est le nom local sous la forme d'une chaîne (voir Notes plus bas pour plus de détails)

Exemple

(Doit être servi avec un type de contenu XML, comme text/xml ou application/xhtml+xml .)

<html xmlns="http://www.w3.org/1999/xhtml"
      xmlns:svg="http://www.w3.org/2000/svg">
<head>
  <script type="application/javascript"><![CDATA[
  function test() {
    var text = document.getElementById('text');
    var circle = document.getElementById('circle');
    
    text.value = "<svg:circle> has:\n" +
                 "localName = '" + circle.localName + "'\n" +
                 "namespaceURI = '" + circle.namespaceURI + "'";
  }
  ]]></script>
</head>
<body onload="test()">
  <svg:svg version="1.1"
    width="100px" height="100px"
    viewBox="0 0 100 100">
    <svg:circle cx="50" cy="50" r="30" style="fill:#aaa" id="circle"/>
  </svg:svg>
  <textarea id="text" rows="4" cols="55"/>
</body>
</html>

Notes

Le nom local d'un nœud est la partie de son nom qualifié qui suit les deux points. Les noms qualifiés sont typiquement utilisés en XML comme parties des espaces de noms de documents XML particuliers. Par exemple, dans le nom qualifié ecomm:partners, partners est le nom local et ecomm est le préfixe :

<ecomm:business id="soda_shop" type="brick_n_mortar">
  <ecomm:partners>
    <ecomm:partner id="1001">Tony's Syrup Warehouse
    </ecomm:partner>
  </ecomm:partner>
</ecomm:business>

Needs to be reworded; right now it's wrong. -Nickolay Le préfixe — dans ce cas « ecomm » — définit l'espace de noms dans lequel le nom local peut être utilisé.

Dans Gecko 1.9.2 et antérieurs, la propriété retourne en casse majuscule le nom local pour les éléments HTML dans le DOM HTML (par opposition aux éléments XHTML dans le DOM XML). Dans les versions ultérieures, en conformité avec HTML5, la propriété renvoie dans le cas d'un stockage DOM interne, en casse minuscule pour les éléments HTML dans le DOM HTML et les éléments XHTML dans le DOM XML. La propriété tagName continue de renvoyer en casse majuscule pour les éléments HTML dans le DOM HTML.

Pour les nœuds de tout autre type qu'ELEMENT_NODE et ATTRIBUTE_NODE, localName vaut toujours null.

Spécifications

Spécification	Statut	Commentaire
Document Object Model (DOM) Level 3 Core Specification La définition de 'Node.localName' dans cette spécification.	Obsolete
Document Object Model (DOM) Level 2 Core Specification La définition de 'Node.localName' dans cette spécification.	Obsolete	Définition initiale

Compatibilité des navigateurs

Update compatibility data on GitHub

	Ordinateur						Mobile
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Webview Android	Chrome pour Android	Firefox pour Android	Opera pour Android	Safari sur iOS	Samsung Internet
`localName` ObsolèteNon-standard	Chrome Aucun support ? — 46 Notes Aucun support ? — 46 Notes Notes This API was moved to the `Element` and `Attr` APIs according to the DOM4 standard.	Edge Aucun support 12 — 79 Notes Aucun support 12 — 79 Notes Notes This API was moved to the `Element` and `Attr` APIs according to the DOM4 standard.	Firefox Aucun support 1 — 48 Notes Aucun support 1 — 48 Notes Notes This API was moved to the `Element` and `Attr` APIs according to the DOM4 standard.	IE ?	Opera ?	Safari ?	WebView Android Aucun support ? — 46 Notes Aucun support ? — 46 Notes Notes This API was moved to the `Element` and `Attr` APIs according to the DOM4 standard.	Chrome Android Aucun support ? — 46 Notes Aucun support ? — 46 Notes Notes This API was moved to the `Element` and `Attr` APIs according to the DOM4 standard.	Firefox Android Support complet 45	Opera Android Support complet Oui	Safari iOS Support complet Oui	Samsung Internet Android Aucun support ? — 5.0 Notes Aucun support ? — 5.0 Notes Notes This API was moved to the `Element` and `Attr` APIs according to the DOM4 standard.

Légende

Support complet: Support complet
Aucun support: Aucun support
Compatibilité inconnue: Compatibilité inconnue
Fonctionnalité non-standard. Celle-ci peut être incorrectement supportée par les autres navigateurs.: Fonctionnalité non-standard. Celle-ci peut être incorrectement supportée par les autres navigateurs.
Obsolète. Les nouveaux sites web ne doivent pas utiliser cette fonctionnalité.: Obsolète. Les nouveaux sites web ne doivent pas utiliser cette fonctionnalité.
Voir les notes d'implémentation.: Voir les notes d'implémentation.

Voir aussi

Dernière modification : Mar 23, 2019, par des contributeurs MDN