diff options
Diffstat (limited to 'files/fr/web/api/attr')
| -rw-r--r-- | files/fr/web/api/attr/index.md | 268 | ||||
| -rw-r--r-- | files/fr/web/api/attr/localname/index.md | 81 | ||||
| -rw-r--r-- | files/fr/web/api/attr/namespaceuri/index.md | 71 | ||||
| -rw-r--r-- | files/fr/web/api/attr/prefix/index.md | 63 |
4 files changed, 199 insertions, 284 deletions
diff --git a/files/fr/web/api/attr/index.md b/files/fr/web/api/attr/index.md index 8a97846bae..930c7df714 100644 --- a/files/fr/web/api/attr/index.md +++ b/files/fr/web/api/attr/index.md @@ -7,155 +7,119 @@ tags: - DOM translation_of: Web/API/Attr --- -<div>{{APIRef("DOM")}}</div> - -<p>Ce type représente un attribut d'un élément DOM comme un objet. Dans la plupart des méthodes DOM, vous auriez probablement récupéré l'attribut directement comme une chaîne (par exemple, {{domxref ("element.getAttribute()")}}, mais certaines fonctions (par exemple, {{domxref ("element.getAttributeNode()" )}}) ou des moyens d'itération donnent des types Attr.</p> - -<div class="warning"> -<p><strong>Attention :</strong> À partir de Gecko 7.0 {{geckoRelease ("7.0")}}, ceux qui vont être retirés afficheront des messages d'avertissement dans la console. Vous devriez modifier votre code en conséquence. Voir {{anch("Propriétés et méthodes dépréciées")}} pour une liste complète.</p> -</div> - -<h2 id="Propriétés">Propriétés</h2> - -<dl> - <dt>{{domxref("Attr.name", "name")}} {{readOnlyInline}}</dt> - <dd>Le nom de l'attribut.</dd> - <dt>{{domxref("Attr.namespaceURI", "namespaceURI")}} {{readOnlyInline}}</dt> - <dd>Une {{domxref("DOMString","Chaîne de caractères")}} représentant l'URI de l'espace nom de l'attribut ou <code>null</code> s'il n'y a pas d'espace nom.</dd> - <dt>{{domxref("Attr.localName", "localName")}} {{readOnlyInline}}</dt> - <dd>Une {{domxref("DOMString","Chaîne de caractères")}} représentant la partie locale du nom qualifié de l'attribut.</dd> - <dt>{{domxref("Attr.prefix", "prefix")}} {{readOnlyInline}}</dt> - <dd>Une {{domxref("DOMString","Chaîne de caractères")}} représentant le préfixe de l'espace nom de l'attribut, ou <code>null</code> si aucun préfixe n'est spécifié.</dd> - <dt>{{domxref("Attr.ownerElement", "ownerElement")}} {{readOnlyInline}}</dt> - <dd>L'élément contenant l'attribut.</dd> -</dl> - -<div class="note"> -<p><strong>Note :</strong> DOM Niveau 4 a supprimé cette propriété . L'hypothèse était que puisque nous obtenons un objet Attr d'un {{domxref("Element")}}, nous devrions déjà connaître les éléments associés.<br> - Comme cela n'est pas vrai quand les objets <code>Attr</code> sont retournés par {{domxref("Document.evaluate")}}, le DOM Living Standard a réintroduit la propriété.</p> - -<p>Gecko affiche une note de dépréciation à partir de Gecko 7.0 {{geckoRelease("7.0")}}. Cette note a été supprimée dans Gecko 49.0 {{geckoRelease("49.0")}}.</p> -</div> - -<dl> - <dt>{{domxref("Attr.specified", "specified")}} {{readOnlyInline}}</dt> - <dd>Cette propriété renvoie toujours la valeur <code>true</code>. À l'origine, elle renvoyait true si l'attribut était explicitement spécifié dans le code source ou par un script, et <code>false</code> si sa valeur provenait de la valeur par défaut définie dans la DTD du document.</dd> - <dt>{{domxref("Attr.value", "Value")}}</dt> - <dd>La valeur de l'attribut.</dd> -</dl> - -<div class="note"> -<p><strong>Note:</strong> DOM Niveau 3 a défini <code>namespaceURI</code>, <code>localName</code> et <code>prefix</code> sur l'interface {{domxref("Node")}}. Dans DOM4 ils ont été déplacés vers <code>Attr</code>.</p> - -<p>Cette modification est implémentée dans Chrome depuis la version 46.0 et Firefox à partir de la version 48.0.</p> -</div> - -<h2 id="Propriétés_et_méthodes_dépréciées">Propriétés et méthodes dépréciées</h2> - -<p>Les propriétés suivantes ont été dépréciées. Si elle est disponible, la méthode ou propriété de remplacement appropriée est fournie.</p> - -<dl> - <dt><code>attributes</code></dt> - <dd>Cette propriété retourne désormais toujours <code>NULL</code>.</dd> - <dt><code>childNodes </code> {{obsolete_inline(14)}}</dt> - <dd>Cette propriété retourne désormais toujours <code>un</code> {{domxref("NodeList")}} vide.</dd> - <dt><code>firstChild </code> {{obsolete_inline(14)}}</dt> - <dd>Cette propriété retourne désormais toujours <code>NULL</code>.</dd> - <dt><code>isId</code> {{readOnlyInline}}</dt> - <dd>Indique si l'attribut est un "attribut ID". Un "attribut ID" étant un attribut dont la valeur devrait être unique dans un document DOM. En HTML DOM, "id" est le seul attribut ID, mais les documents XML peuvent en définir d'autres. Qu'un attribut soit unique ou non est souvent déterminé par un {{Glossary("DTD")}} ou une autre description de schéma.</dd> - <dt><code>lastChild </code> {{obsolete_inline(14)}}</dt> - <dd>Cette propriété retourne désormais toujours <code>NULL</code>.</dd> - <dt><code>nextSibling</code></dt> - <dd>Cette propriété retourne désormais toujours <code>NULL</code>.</dd> - <dt><code>nodeName</code></dt> - <dd>Utilisez {{domxref("Attr.name")}} à la place.</dd> - <dt><code>nodeType</code></dt> - <dd>Cette propriété retourne toujours 2. (<code>ATTRIBUTE_NODE</code>).</dd> - <dt><code>nodeValue</code></dt> - <dd>Utilisez {{domxref("Attr.value")}} à la place.</dd> - <dt><code>ownerDocument</code></dt> - <dd>Vous n'auriez pas dû l'utiliser en premier lieu, donc cela ne devrait pas vous ennuyer qu'il soit retiré.</dd> - <dt><code>parentNode</code></dt> - <dd>Cette propriété retourne désormais toujours NULL.</dd> - <dt><code>previousSibling</code></dt> - <dd>Cette propriété retourne désormais toujours NULL.</dd> - <dt><code>schemaTypeInfo</code> {{obsolete_inline}} {{readOnlyInline}}</dt> - <dd>Les informations de type associées à cet attribut. Bien que l'information de type contenue dans cet attribut soit garantie après le chargement du document ou l'appel de {{domxref("Document.normalizeDocument")}}, cette propriété peut ne pas être fiable si le nœud a été déplacé.</dd> - <dt><code>specified</code></dt> - <dd>Cette propriété retourne désormais toujours true.</dd> - <dt><code>textContent</code></dt> - <dd>Utilisez {{domxref ("Attr.value")}} à la place.</dd> -</dl> - -<p><br> - Les méthodes suivantes ont été dépréciées:</p> - -<dl> - <dt><code>appendChild() </code> {{obsolete_inline(14)}}</dt> - <dd>Modifiez à la place la valeur de {{domxref ("Attr.value")}}.</dd> - <dt><code>cloneNode()</code></dt> - <dd>Vous n'auriez pas dû l'utiliser en premier lieu, donc cela ne devrait pas vous ennuyer qu'il soit retiré.</dd> - <dt><code>createAttribute()</code></dt> - <dd>Utilisez {{domxref("Attr.setAttribute()")}} à la place.</dd> - <dt><code>createAttributeNS()</code></dt> - <dd>Utilisez {{domxref("Attr.setAttributeNS()")}} à la place.</dd> - <dt><code>getAttributeNode()</code></dt> - <dd>Utilisez {{domxref("Attr.getAttribute()")}} à la place.</dd> - <dt><code>getAttributeNodeNS()</code></dt> - <dd>Utilisez {{domxref("Attr.getAttributeNS()")}} à la place.</dd> - <dt><code>hasAttributes() </code>{{obsolete_inline("21.0")}}</dt> - <dd>Cette méthode retourne désormais toujours false.</dd> - <dt><code>hasChildNodes()</code></dt> - <dd>Cette méthode retourne désormais toujours false.</dd> - <dt><code>insertBefore()</code></dt> - <dd>Modifiez à la place la valeur de {{domxref ("Attr.value")}}.</dd> - <dt><code>isSupported()</code></dt> - <dd>Vous n'auriez pas dû l'utiliser en premier lieu, donc cela ne devrait pas vous ennuyer qu'il soit retiré.</dd> - <dt><code>isEqualNode()</code></dt> - <dd>Vous n'auriez pas dû l'utiliser en premier lieu, donc cela ne devrait pas vous ennuyer qu'il soit retiré.</dd> - <dt><code>normalize()</code></dt> - <dd>Vous n'auriez pas dû l'utiliser en premier lieu, donc cela ne devrait pas vous ennuyer qu'il soit retiré.</dd> - <dt><code>removeAttributeNode()</code></dt> - <dd>Utilisez {{domxref("Attr.removeAttribute()")}} à la place.</dd> - <dt><code>removeChild() </code> {{obsolete_inline(14)}}</dt> - <dd>Modifiez à la place la valeur de {{domxref("Attr.value")}}.</dd> - <dt><code>replaceChild() </code> {{obsolete_inline(14)}}</dt> - <dd>Modifiez à la place la valeur de {{domxref("Attr.value")}}.</dd> - <dt><code>setAttributeNode()</code></dt> - <dd>Utilisez {{domxref("Attr.setAttribute()")}} à la place.</dd> - <dt><code>setAttributeNodeNS()</code></dt> - <dd>Utilisez {{domxref("Attr.setAttributeNS()")}} à la place.</dd> -</dl> - -<h2 id="Spécifications">Spécifications</h2> - -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Spécification</th> - <th scope="col">Statut</th> - <th scope="col">Commentaire</th> - </tr> - </thead> - <tbody> - <tr> - <td>{{SpecName("DOM WHATWG", "#interface-attr", "Attr")}}</td> - <td>{{Spec2("DOM WHATWG")}}</td> - <td>Ajoute la propriété <code>ownerElement</code> property</td> - </tr> - <tr> - <td>{{SpecName("DOM4", "#interface-attr", "Attr")}}</td> - <td>{{Spec2("DOM4")}}</td> - <td>A déplacé les <code>namespaceURI</code>, <code>prefix</code> et <code>localName</code> de {{domxref("Node")}} vers cet API et supprimé <code>ownerElement</code>, <code>schemaTypeInfo</code> et <code>isId</code>.</td> - </tr> - <tr> - <td>{{SpecName("DOM3 Core", "core.html#ID-637646024", "Attr")}}</td> - <td>{{Spec2("DOM3 Core")}}</td> - <td>Définition initiale</td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> - -<p>{{Compat("api.Attr")}}</p> +{{APIRef("DOM")}} + +Ce type représente un attribut d'un élément DOM comme un objet. Dans la plupart des méthodes DOM, vous auriez probablement récupéré l'attribut directement comme une chaîne (par exemple, {{domxref ("element.getAttribute()")}}, mais certaines fonctions (par exemple, {{domxref ("element.getAttributeNode()" )}}) ou des moyens d'itération donnent des types Attr. + +> **Attention :** À partir de Gecko 7.0 {{geckoRelease ("7.0")}}, ceux qui vont être retirés afficheront des messages d'avertissement dans la console. Vous devriez modifier votre code en conséquence. Voir {{anch("Propriétés et méthodes dépréciées")}} pour une liste complète. + +## Propriétés + +- {{domxref("Attr.name", "name")}} {{readOnlyInline}} + - : Le nom de l'attribut. +- {{domxref("Attr.namespaceURI", "namespaceURI")}} {{readOnlyInline}} + - : Une {{domxref("DOMString","Chaîne de caractères")}} représentant l'URI de l'espace nom de l'attribut ou `null` s'il n'y a pas d'espace nom. +- {{domxref("Attr.localName", "localName")}} {{readOnlyInline}} + - : Une {{domxref("DOMString","Chaîne de caractères")}} représentant la partie locale du nom qualifié de l'attribut. +- {{domxref("Attr.prefix", "prefix")}} {{readOnlyInline}} + - : Une {{domxref("DOMString","Chaîne de caractères")}} représentant le préfixe de l'espace nom de l'attribut, ou `null` si aucun préfixe n'est spécifié. +- {{domxref("Attr.ownerElement", "ownerElement")}} {{readOnlyInline}} + - : L'élément contenant l'attribut. + +> **Note :** DOM Niveau 4 a supprimé cette propriété . L'hypothèse était que puisque nous obtenons un objet Attr d'un {{domxref("Element")}}, nous devrions déjà connaître les éléments associés. +> Comme cela n'est pas vrai quand les objets `Attr` sont retournés par {{domxref("Document.evaluate")}}, le DOM Living Standard a réintroduit la propriété. +> +> Gecko affiche une note de dépréciation à partir de Gecko 7.0 {{geckoRelease("7.0")}}. Cette note a été supprimée dans Gecko 49.0 {{geckoRelease("49.0")}}. + +- {{domxref("Attr.specified", "specified")}} {{readOnlyInline}} + - : Cette propriété renvoie toujours la valeur `true`. À l'origine, elle renvoyait true si l'attribut était explicitement spécifié dans le code source ou par un script, et `false` si sa valeur provenait de la valeur par défaut définie dans la DTD du document. +- {{domxref("Attr.value", "Value")}} + - : La valeur de l'attribut. + +> **Note :** DOM Niveau 3 a défini `namespaceURI`, `localName` et `prefix` sur l'interface {{domxref("Node")}}. Dans DOM4 ils ont été déplacés vers `Attr`. +> +> Cette modification est implémentée dans Chrome depuis la version 46.0 et Firefox à partir de la version 48.0. + +## Propriétés et méthodes dépréciées + +Les propriétés suivantes ont été dépréciées. Si elle est disponible, la méthode ou propriété de remplacement appropriée est fournie. + +- `attributes` + - : Cette propriété retourne désormais toujours `NULL`. +- `childNodes `{{obsolete_inline(14)}} + - : Cette propriété retourne désormais toujours `un` {{domxref("NodeList")}} vide. +- `firstChild `{{obsolete_inline(14)}} + - : Cette propriété retourne désormais toujours `NULL`. +- `isId` {{readOnlyInline}} + - : Indique si l'attribut est un "attribut ID". Un "attribut ID" étant un attribut dont la valeur devrait être unique dans un document DOM. En HTML DOM, "id" est le seul attribut ID, mais les documents XML peuvent en définir d'autres. Qu'un attribut soit unique ou non est souvent déterminé par un {{Glossary("DTD")}} ou une autre description de schéma. +- `lastChild `{{obsolete_inline(14)}} + - : Cette propriété retourne désormais toujours `NULL`. +- `nextSibling` + - : Cette propriété retourne désormais toujours `NULL`. +- `nodeName` + - : Utilisez {{domxref("Attr.name")}} à la place. +- `nodeType` + - : Cette propriété retourne toujours 2. (`ATTRIBUTE_NODE`). +- `nodeValue` + - : Utilisez {{domxref("Attr.value")}} à la place. +- `ownerDocument` + - : Vous n'auriez pas dû l'utiliser en premier lieu, donc cela ne devrait pas vous ennuyer qu'il soit retiré. +- `parentNode` + - : Cette propriété retourne désormais toujours NULL. +- `previousSibling` + - : Cette propriété retourne désormais toujours NULL. +- `schemaTypeInfo` {{obsolete_inline}} {{readOnlyInline}} + - : Les informations de type associées à cet attribut. Bien que l'information de type contenue dans cet attribut soit garantie après le chargement du document ou l'appel de {{domxref("Document.normalizeDocument")}}, cette propriété peut ne pas être fiable si le nœud a été déplacé. +- `specified` + - : Cette propriété retourne désormais toujours true. +- `textContent` + - : Utilisez {{domxref ("Attr.value")}} à la place. + +Les méthodes suivantes ont été dépréciées: + +- `appendChild() `{{obsolete_inline(14)}} + - : Modifiez à la place la valeur de {{domxref ("Attr.value")}}. +- `cloneNode()` + - : Vous n'auriez pas dû l'utiliser en premier lieu, donc cela ne devrait pas vous ennuyer qu'il soit retiré. +- `createAttribute()` + - : Utilisez {{domxref("Attr.setAttribute()")}} à la place. +- `createAttributeNS()` + - : Utilisez {{domxref("Attr.setAttributeNS()")}} à la place. +- `getAttributeNode()` + - : Utilisez {{domxref("Attr.getAttribute()")}} à la place. +- `getAttributeNodeNS()` + - : Utilisez {{domxref("Attr.getAttributeNS()")}} à la place. +- `hasAttributes() `{{obsolete_inline("21.0")}} + - : Cette méthode retourne désormais toujours false. +- `hasChildNodes()` + - : Cette méthode retourne désormais toujours false. +- `insertBefore()` + - : Modifiez à la place la valeur de {{domxref ("Attr.value")}}. +- `isSupported()` + - : Vous n'auriez pas dû l'utiliser en premier lieu, donc cela ne devrait pas vous ennuyer qu'il soit retiré. +- `isEqualNode()` + - : Vous n'auriez pas dû l'utiliser en premier lieu, donc cela ne devrait pas vous ennuyer qu'il soit retiré. +- `normalize()` + - : Vous n'auriez pas dû l'utiliser en premier lieu, donc cela ne devrait pas vous ennuyer qu'il soit retiré. +- `removeAttributeNode()` + - : Utilisez {{domxref("Attr.removeAttribute()")}} à la place. +- `removeChild() `{{obsolete_inline(14)}} + - : Modifiez à la place la valeur de {{domxref("Attr.value")}}. +- `replaceChild() `{{obsolete_inline(14)}} + - : Modifiez à la place la valeur de {{domxref("Attr.value")}}. +- `setAttributeNode()` + - : Utilisez {{domxref("Attr.setAttribute()")}} à la place. +- `setAttributeNodeNS()` + - : Utilisez {{domxref("Attr.setAttributeNS()")}} à la place. + +## Spécifications + +| Spécification | Statut | Commentaire | +| -------------------------------------------------------------------------------- | -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ | +| {{SpecName("DOM WHATWG", "#interface-attr", "Attr")}} | {{Spec2("DOM WHATWG")}} | Ajoute la propriété `ownerElement` property | +| {{SpecName("DOM4", "#interface-attr", "Attr")}} | {{Spec2("DOM4")}} | A déplacé les `namespaceURI`, `prefix` et `localName` de {{domxref("Node")}} vers cet API et supprimé `ownerElement`, `schemaTypeInfo` et `isId`. | +| {{SpecName("DOM3 Core", "core.html#ID-637646024", "Attr")}} | {{Spec2("DOM3 Core")}} | Définition initiale | + +## Compatibilité des navigateurs + +{{Compat("api.Attr")}} diff --git a/files/fr/web/api/attr/localname/index.md b/files/fr/web/api/attr/localname/index.md index c23a595af4..a2f6f2e717 100644 --- a/files/fr/web/api/attr/localname/index.md +++ b/files/fr/web/api/attr/localname/index.md @@ -8,78 +8,61 @@ tags: - Reference translation_of: Web/API/Attr/localName --- -<div>{{APIRef("DOM")}}</div> +{{APIRef("DOM")}} -<p>La propriété <code><strong>Attr.localName</strong></code>, en lecture seule, renvoie la partie locale du nom qualifié d'un élément.</p> +La propriété **`Attr.localName`**, en lecture seule, renvoie la partie locale du nom qualifié d'un élément. -<div class="note"> -<p><strong>Note :</strong> Avant DOM4, cette API était définie dans l'interface {{domxref("Node")}}.</p> -</div> +> **Note :** Avant DOM4, cette API était définie dans l'interface {{domxref("Node")}}. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox"><var>name</var> = <var>attribute</var>.localName -</pre> + name = attribute.localName -<h3 id="Valeur_renvoyée">Valeur renvoyée</h3> +### Valeur renvoyée -<p>Une {{domxref("DOMString")}} <em>(chaîne de caractères)</em> qui représente la partie locale du nom qualifié de l'élément.</p> +Une {{domxref("DOMString")}} _(chaîne de caractères)_ qui représente la partie locale du nom qualifié de l'élément. -<h2 id="Exemple">Exemple</h2> +## Exemple -<p>Cet exemple affiche "id" dans une fenêtre d'alerte.</p> +Cet exemple affiche "id" dans une fenêtre d'alerte. -<h3 id="Contenu_HTML">Contenu HTML</h3> +### Contenu HTML -<pre class="brush: html"><button id="exemple">Clique ici</button></pre> +```html +<button id="exemple">Clique ici</button> +``` -<h3 id="Contenu_JavaScript">Contenu JavaScript</h3> +### Contenu JavaScript -<pre class="brush: js">const element = document.querySelector("#exemple"); +```js +const element = document.querySelector("#exemple"); element.addEventListener("click", function() { const attribute = element.attributes[0]; alert(attribute.localName); }); -</pre> +``` -<p>{{ EmbedLiveSample('Exemple','100%',30) }}</p> +{{ EmbedLiveSample('Exemple','100%',30) }} -<h2 id="Notes">Notes</h2> +## Notes -<p>Le nom local d'un attribut est la partie du nom qualifié de cet attribut avant les deux points. les noms qualifiés sont utilisés en XML, dans les espaces de nom de certains documents.</p> +Le nom local d'un attribut est la partie du nom qualifié de cet attribut avant les deux points. les noms qualifiés sont utilisés en XML, dans les espaces de nom de certains documents. -<div class="note"> -<p><strong>Note :</strong> dans {{Gecko("1.9.2")}} et avant, cette propriété renvoie le nom en majuscule pour les attributs HTML du DOM HTML (contrairement aux atttributs XHTML ). Dans les versions plus récentes, en accord avec HTML5, cette propriété renvoie la casse correspondante au DOM utilisé, c'est-à-dire en minuscule pour les attributs du DOM XHTMl et du DOM HTML.</p> -</div> +> **Note :** dans {{Gecko("1.9.2")}} et avant, cette propriété renvoie le nom en majuscule pour les attributs HTML du DOM HTML (contrairement aux atttributs XHTML ). Dans les versions plus récentes, en accord avec HTML5, cette propriété renvoie la casse correspondante au DOM utilisé, c'est-à-dire en minuscule pour les attributs du DOM XHTMl et du DOM HTML. -<h2 id="Spécifications">Spécifications</h2> +## Spécifications -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Spécification</th> - <th scope="col">Statut</th> - <th scope="col">Commentaire</th> - </tr> - </thead> - <tbody> - <tr> - <td>{{SpecName('DOM4', '#interface-attr', 'Attr.localName')}}</td> - <td>{{Spec2('DOM4')}}</td> - <td>première définition</td> - </tr> - </tbody> -</table> +| Spécification | Statut | Commentaire | +| ---------------------------------------------------------------------------- | ------------------------ | ------------------- | +| {{SpecName('DOM4', '#interface-attr', 'Attr.localName')}} | {{Spec2('DOM4')}} | première définition | -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> +## Compatibilité des navigateurs -<p>{{Compat("api.Attr.localName")}}</p> +{{Compat("api.Attr.localName")}} -<h2 id="Voir_également">Voir également</h2> +## Voir également -<ul> - <li>{{domxref("Attr.namespaceURI")}}</li> - <li>{{domxref("Attr.prefix")}}</li> - <li>{{domxref("Element.localName")}}</li> - <li>{{domxref("Node.localName")}}</li> -</ul> +- {{domxref("Attr.namespaceURI")}} +- {{domxref("Attr.prefix")}} +- {{domxref("Element.localName")}} +- {{domxref("Node.localName")}} diff --git a/files/fr/web/api/attr/namespaceuri/index.md b/files/fr/web/api/attr/namespaceuri/index.md index 73f89cbdeb..a8d555f0d8 100644 --- a/files/fr/web/api/attr/namespaceuri/index.md +++ b/files/fr/web/api/attr/namespaceuri/index.md @@ -8,67 +8,52 @@ tags: - namespaceURI translation_of: Web/API/Attr/namespaceURI --- -<div>{{APIRef("DOM")}}</div> +{{APIRef("DOM")}} -<p>La propriété en lecture seule <code><strong>Attr.namespaceURI</strong></code> retourne l'URI d'espace de nom de l'attribut, ou <code>null</code> si l'élément n'est pas dans un espace de noms.</p> +La propriété en lecture seule **`Attr.namespaceURI`** retourne l'URI d'espace de nom de l'attribut, ou `null` si l'élément n'est pas dans un espace de noms. -<div class="note"> -<p><strong>Note :</strong> Avant DOM4 cet API était défini dans l'interface {{domxref("Node")}}.</p> -</div> +> **Note :** Avant DOM4 cet API était défini dans l'interface {{domxref("Node")}}. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox"><var>namespace</var> = <var>attribute</var>.namespaceURI</pre> + namespace = attribute.namespaceURI -<h2 id="Exemple">Exemple</h2> +## Exemple -<p>Dans cet extrait de code, un attribut est examiné pour son {{domxref("localName")}} et son <code>namespaceURI</code>. Si le <code>namespaceURI</code> renvoie l'espace de noms XUL et le <code>localName</code> retourne "browser" (<em>navigateur</em>), alors le noeud est compris comme étant un <code><browser/></code> XUL.</p> +Dans cet extrait de code, un attribut est examiné pour son {{domxref("localName")}} et son `namespaceURI`. Si le `namespaceURI` renvoie l'espace de noms XUL et le `localName` retourne "browser" (_navigateur_), alors le noeud est compris comme étant un `<browser/>` XUL. -<pre class="brush:js">if (attribute.localName == "value" && +```js +if (attribute.localName == "value" && attribute.namespaceURI == "http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul") { // ceci est une valeur XUL -}</pre> +} +``` -<h2 id="Notes">Notes</h2> +## Notes -<p>Ce n'est pas une valeur calculée, mais le résultat d'une recherche d'espace de noms basée sur un examen des déclarations d'espace de noms dans la portée. L'URI de l'espace de noms d'un attribut est figé à l'heure de création de l'attribut.</p> +Ce n'est pas une valeur calculée, mais le résultat d'une recherche d'espace de noms basée sur un examen des déclarations d'espace de noms dans la portée. L'URI de l'espace de noms d'un attribut est figé à l'heure de création de l'attribut. -<p>Dans Firefox 3.5 et précédents, l'URI d'espace de nom pour les attributs HTML dans les documents HTML est <code>null</code>. Dans les versions ultérieures, en conformité avec HTML5, il est <code><a href="https://www.w3.org/1999/xhtml">https://www.w3.org/1999/xhtml</a></code> comme dans XHTML. {{gecko_minversion_inline("1.9.2")}}</p> +Dans Firefox 3.5 et précédents, l'URI d'espace de nom pour les attributs HTML dans les documents HTML est `null`. Dans les versions ultérieures, en conformité avec HTML5, il est [`https://www.w3.org/1999/xhtml`](https://www.w3.org/1999/xhtml) comme dans XHTML. {{gecko_minversion_inline("1.9.2")}} -<p>Vous pouvez créer un attribut avec le <code>namespaceURI</code> spécifié en utilisant la méthode de DOM niveau 2 {{domxref("Element.setAttributeNS")}}.</p> +Vous pouvez créer un attribut avec le `namespaceURI` spécifié en utilisant la méthode de DOM niveau 2 {{domxref("Element.setAttributeNS")}}. -<p>Selon la spécification <a href="https://www.w3.org/TR/xml-names11/">Namespaces en XML</a>, un attribut n'hérite pas de l'espace de noms de l'élément auquel il est attaché. Si un attribut n'est pas explicitement donné à un espace de noms, il n'a pas d'espace de noms.</p> +Selon la spécification [Namespaces en XML](https://www.w3.org/TR/xml-names11/), un attribut n'hérite pas de l'espace de noms de l'élément auquel il est attaché. Si un attribut n'est pas explicitement donné à un espace de noms, il n'a pas d'espace de noms. -<p>Le DOM ne gère pas ou n'applique pas la validation de l'espace de noms en soi. Il appartient à l'application DOM de faire toute validation nécessaire. Notez également que le préfixe d'espace de noms, une fois associé à un nœud particulier, ne peut pas être modifié.</p> +Le DOM ne gère pas ou n'applique pas la validation de l'espace de noms en soi. Il appartient à l'application DOM de faire toute validation nécessaire. Notez également que le préfixe d'espace de noms, une fois associé à un nœud particulier, ne peut pas être modifié. -<h2 id="Spécifications">Spécifications</h2> +## Spécifications -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Spécification</th> - <th scope="col">Statut</th> - <th scope="col">Commentaire</th> - </tr> - </thead> - <tbody> - <tr> - <td>{{SpecName("DOM4", "#dom-element-namespaceuri", "Element.namespaceuri")}}</td> - <td>{{Spec2("DOM4")}}</td> - <td>Définition initiale</td> - </tr> - </tbody> -</table> +| Spécification | Statut | Commentaire | +| ------------------------------------------------------------------------------------------------ | ------------------------ | ------------------- | +| {{SpecName("DOM4", "#dom-element-namespaceuri", "Element.namespaceuri")}} | {{Spec2("DOM4")}} | Définition initiale | -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> +## Compatibilité des navigateurs -<p>{{Compat("api.Attr.namespaceURI")}}</p> +{{Compat("api.Attr.namespaceURI")}} -<h2 id="Voir_aussi">Voir aussi</h2> +## Voir aussi -<ul> - <li>{{domxref("Attr.localName")}}</li> - <li>{{domxref("Attr.prefix")}}</li> - <li>{{domxref("Element.namespaceURI")}}</li> - <li>{{domxref("Node.namespaceURI")}}</li> -</ul> +- {{domxref("Attr.localName")}} +- {{domxref("Attr.prefix")}} +- {{domxref("Element.namespaceURI")}} +- {{domxref("Node.namespaceURI")}} diff --git a/files/fr/web/api/attr/prefix/index.md b/files/fr/web/api/attr/prefix/index.md index 92f9bcfe1b..94ebc28721 100644 --- a/files/fr/web/api/attr/prefix/index.md +++ b/files/fr/web/api/attr/prefix/index.md @@ -8,58 +8,41 @@ tags: - Reference translation_of: Web/API/Attr/prefix --- -<div>{{APIRef("DOM")}}</div> +{{APIRef("DOM")}} -<p>La propriété <strong><code>Attr.prefix </code></strong>en lecture seule renvoie le préfixe de l'espace de noms de l'attribut spécifié ou null si aucun préfixe n'est spécifié</p> +La propriété **`Attr.prefix `**en lecture seule renvoie le préfixe de l'espace de noms de l'attribut spécifié ou null si aucun préfixe n'est spécifié -<div class="note"> -<p><strong>Note :</strong> Avant DOM4, cette API a été définie dans l'interface {{domxref ("Node")}}.</p> -</div> +> **Note :** Avant DOM4, cette API a été définie dans l'interface {{domxref ("Node")}}. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox"><var>string</var> = <var>attribute</var>.prefix -</pre> + string = attribute.prefix -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Le code suivant affiche "x" dans la console.</p> +Le code suivant affiche "x" dans la console. -<pre class="brush:xml"><div x:id="example" onclick="console.log(this.attributes[0].prefix)"/> -</pre> +```xml +<div x:id="example" onclick="console.log(this.attributes[0].prefix)"/> +``` -<h2 id="Notes">Notes</h2> +## Notes -<p>Cela ne fonctionnera que lorsqu'un analyseur conscient de l'espace de noms est utilisé, c'est-à-dire lorsqu'il s'agit d'un document avec un type MIME XML. Cela ne fonctionnera pas pour les documents HTML.</p> +Cela ne fonctionnera que lorsqu'un analyseur conscient de l'espace de noms est utilisé, c'est-à-dire lorsqu'il s'agit d'un document avec un type MIME XML. Cela ne fonctionnera pas pour les documents HTML. -<h2 id="Spécifications">Spécifications</h2> +## Spécifications -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Spécification</th> - <th scope="col">Statut</th> - <th scope="col">Commentaire</th> - </tr> - </thead> - <tbody> - <tr> - <td>{{SpecName("DOM4", "#dom-attr-prefix", "Attr.prefix")}}</td> - <td>{{Spec2("DOM4")}}</td> - <td>Définition initiale</td> - </tr> - </tbody> -</table> +| Spécification | Statut | Commentaire | +| ------------------------------------------------------------------------ | ------------------------ | ------------------- | +| {{SpecName("DOM4", "#dom-attr-prefix", "Attr.prefix")}} | {{Spec2("DOM4")}} | Définition initiale | -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> +## Compatibilité des navigateurs -<p>{{Compat("api.Attr.prefix")}}</p> +{{Compat("api.Attr.prefix")}} -<h2 id="Voir_également">Voir également</h2> +## Voir également -<ul> - <li>{{domxref("Attr.namespaceURI")}}</li> - <li>{{domxref("Attr.localName")}}</li> - <li>{{domxref("Element.prefix")}}</li> - <li>{{domxref("Node.prefix")}}</li> -</ul> +- {{domxref("Attr.namespaceURI")}} +- {{domxref("Attr.localName")}} +- {{domxref("Element.prefix")}} +- {{domxref("Node.prefix")}} |