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.
Syntaxe
name = element.localName
nameest 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
| Fonctionnalité | Chrome | Edge | Firefox | Internet Explorer | Opera | Safari |
|---|---|---|---|---|---|---|
| Support simple | Oui — 461 | 12 | 1 — 481 | ? | ? | ? |
| Fonctionnalité | Android webview | Chrome for Android | Edge mobile | Firefox for Android | Opera Android | iOS Safari | Samsung Internet |
|---|---|---|---|---|---|---|---|
| Support simple | Oui — 461 | Oui — 461 | Oui | 45 | Oui | Oui | Oui |
1. This API was moved to the Element and Attr APIs according to the DOM4 standard.
Voir aussi