--- title: element.localName slug: Web/API/Node/localName tags: - API - DOM - Noeuds - Nom local - Propriétés translation_of: Web/API/Node/localName ---

{{APIRef("DOM")}}{{obsolete_header}}

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 {{domxref("Element")}} et {{domxref("Attr")}}.

Syntaxe

name = element.localName

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é  {{domxref("element.tagName","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
{{SpecName('DOM3 Core', 'core.html#ID-NodeNSLocalN', 'Node.localName')}} {{Spec2('DOM3 Core')}}  
{{SpecName('DOM2 Core', 'core.html#ID-NodeNSLocalN', 'Node.localName')}} {{Spec2('DOM2 Core')}} Définition initiale

Compatibilité des navigateurs

{{Compat("api.Node.localName")}}

Voir aussi