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

Nous convertissons les données de compatibilité dans un format JSON. Ce tableau de compatibilité utilise encore l'ancien format car nous n'avons pas encore converti les données qu'il contient. Vous pouvez nous aider en contribuant !

Fonctionnalité Chrome Edge Firefox (Gecko) Internet Explorer Opera Safari
Basic support (Oui)
Pas de support46.0[1]
(Oui) 1.0 (1.7 ou moins)
Pas de support 48.0 (48.0)[1]
? ? ?
Fonctionnalité Android Edge Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Basic support ? (Oui) 1.0 (1.0)
Pas de support 48.0 (48.0)[1]
? ? ?

[1] Cette API a été déplacée vers les API Element et Attr en accord avec la norme DOM4.

Voir aussi

 

Étiquettes et contributeurs liés au document

Étiquettes : 
 Contributeurs à cette page : loella16, fscholz, teoli, khalid32, BenoitL
 Dernière mise à jour par : loella16,