element.localName

Aller à :
  1. Syntaxe
  2. Exemple
  3. Notes
  4. Spécifications
  5. Compatibilité des navigateurs

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
OrdinateurMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariWebview AndroidChrome pour AndroidEdge MobileFirefox pour AndroidOpera pour AndroidSafari pour iOSSamsung Internet
Support simple
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 Support complet 12Firefox 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.
Edge Mobile Support complet OuiFirefox Android Support complet 45Opera Android Support complet OuiSafari iOS Support complet OuiSamsung Internet Android Support complet Oui

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

 

Étiquettes et contributeurs liés au document

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