diff options
| author | Peter Bengtsson <mail@peterbe.com> | 2020-12-08 14:40:17 -0500 |
|---|---|---|
| committer | Peter Bengtsson <mail@peterbe.com> | 2020-12-08 14:40:17 -0500 |
| commit | 33058f2b292b3a581333bdfb21b8f671898c5060 (patch) | |
| tree | 51c3e392513ec574331b2d3f85c394445ea803c6 /files/fr/web/api/attr/index.html | |
| parent | 8b66d724f7caf0157093fb09cfec8fbd0c6ad50a (diff) | |
| download | translated-content-33058f2b292b3a581333bdfb21b8f671898c5060.tar.gz translated-content-33058f2b292b3a581333bdfb21b8f671898c5060.tar.bz2 translated-content-33058f2b292b3a581333bdfb21b8f671898c5060.zip | |
initial commit
Diffstat (limited to 'files/fr/web/api/attr/index.html')
| -rw-r--r-- | files/fr/web/api/attr/index.html | 217 |
1 files changed, 217 insertions, 0 deletions
diff --git a/files/fr/web/api/attr/index.html b/files/fr/web/api/attr/index.html new file mode 100644 index 0000000000..171e224254 --- /dev/null +++ b/files/fr/web/api/attr/index.html @@ -0,0 +1,217 @@ +--- +title: Attr +slug: Web/API/Attr +tags: + - API + - Attribut + - 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")}} <span id="result_box" lang="fr"><span>représentant l'URI de l'espace nom de l'attribut ou <code>null</code> s'il n'y a pas d'espace nom.</span></span></dd> + <dt>{{domxref("Attr.localName", "localName")}} {{readOnlyInline}}</dt> + <dd>Une {{domxref("DOMString","Chaîne de caractères")}} représentant <span class="short_text" id="result_box" lang="fr"><span>la partie locale du nom qualifié de l'attribut.</span></span></dd> + <dt>{{domxref("Attr.prefix", "prefix")}} {{readOnlyInline}}</dt> + <dd>Une {{domxref("DOMString","Chaîne de caractères")}} représentant <span id="result_box" lang="fr"><span> le préfixe de l'espace nom de l'attribut, ou <code>null</code> si aucun préfixe n'est spécifié.</span></span></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 <span class="short_text" id="result_box" lang="fr"><span>a supprimé cette propriété</span></span> . <span id="result_box" lang="fr"><span>L'hypothèse était que puisque nous obtenons un objet Attr d'un</span></span> {{domxref("Element")}}, nous devrions déjà connaître les éléments associés.<br> + <span class="short_text" id="result_box" lang="fr"><span>Comme cela n'est pas vrai quand les objets</span></span> <code>Attr</code> sont retournés par {{domxref("Document.evaluate")}}, <span class="short_text" id="result_box" lang="fr"><span>le DOM Living Standard a réintroduit la propriété.</span></span></p> + +<p><span class="short_text" id="result_box" lang="fr"><span>Gecko affiche une note de dépréciation à partir de</span></span> 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><span id="result_box" lang="fr"><span>Cette propriété renvoie toujours la valeur <code>true</code>.</span> <span>À 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.</span></span></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"><span class="short_text" id="result_box" lang="fr"><span class="hps">Propriétés et méthodes</span> <span class="hps">dépréciées</span></span></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><span id="result_box" lang="fr"><span>Indique si l'attribut est un "attribut ID".</span> <span>Un "attribut ID" étant un attribut dont la valeur devrait être unique dans un document DOM.</span> <span>En HTML DOM, "id" est le seul attribut ID, mais les documents XML peuvent en définir d'autres.</span> <span>Qu'un attribut soit unique ou non est souvent déterminé par</span></span> 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><span id="result_box" lang="fr"><span>Les informations de type associées à cet attribut.</span> <span>Bien que l'information de type contenue dans cet attribut soit garantie après le chargement du document ou l'appel de</span></span> {{domxref("Document.normalizeDocument")}}, cette propriété <span id="result_box" lang="fr"><span>peut ne pas être fiable si le nœud a été déplacé.</span></span></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>{{CompatibilityTable}}</p> + +<div id="compat-desktop"> +<table class="compat-table"> + <tbody> + <tr> + <th>Fonctionnalité</th> + <th>Chrome</th> + <th>Edge</th> + <th>Firefox (Gecko)</th> + <th>Internet Explorer</th> + <th>Opera</th> + <th>Safari</th> + </tr> + <tr> + <td>Basic support</td> + <td>{{CompatVersionUnknown}}<sup>[1]</sup></td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatVersionUnknown}}</td> + </tr> + </tbody> +</table> +</div> + +<div id="compat-mobile"> +<table class="compat-table"> + <tbody> + <tr> + <th>Fonctionnalité</th> + <th>Android</th> + <th>Android Webview</th> + <th>Edge</th> + <th>Firefox Mobile (Gecko)</th> + <th>IE Mobile</th> + <th>Opera Mobile</th> + <th>Safari Mobile</th> + <th>Chrome for Android</th> + </tr> + <tr> + <td>Basic support</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatVersionUnknown}}<sup>[1]</sup></td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatVersionUnknown}}<sup>[1]</sup></td> + </tr> + </tbody> +</table> +</div> + +<p>[1] À partir de Chrome 45, cette propriété n'hérite plus de Node.</p> |
