element.setAttribute

  • Raccourci de la révision : DOM/element.setAttribute
  • Titre de la révision : element.setAttribute
  • ID de la révision : 167367
  • Créé :
  • Créateur : Mgjbot
  • Version actuelle ? Oui
  • Commentaire robot Ajoute: [[ja:DOM:element.setAttribute]] <<langbot>>

Contenu de la révision

{{ DomRef() }}

Résumé

Ajoute un nouvel attribut ou change la valeur d'un attribut existant pour l'élément spécifié.

Syntaxe

element.setAttribute(nom, valeur);
  • nom est le nom du nouvel attribut sous forme de chaîne.
  • valeur est la nouvelle valeur désirée de l'attribut.

Exemple

var d = document.getElementById("d1"); 
d.setAttribute("align", "center");

Notes

Si l'attribut spécifié existe déjà, sa valeur est modifiée en la valeur reçue en paramètre. S'il n'existe pas encore, l'attribut est créé.

Même si getAttribute() renvoie null pour les attributs manquants, il vaut mieux utiliser removeAttribute() plutôt que elt.setAttribute(attr, null) pour enlever un attribut.

L'utilisation de setAttribute() pour modifier certains attributs, en particulier value en XUL et HTML ou selected en HTML, ne conduit pas toujours au résultat attendu, étant donné que l'attribut spécifie juste la valeur par défaut. Pour accéder ou modifier les valeurs courantes, il vaut mieux utiliser les propriétés correspondantes. Par exemple, utilisez elt.value plutôt que elt.setAttribute('value', val).

{{ DOMAttributeMethods() }}

Spécification

{{ languages( { "en": "en/DOM/element.setAttribute", "ja": "ja/DOM/element.setAttribute", "pl": "pl/DOM/element.setAttribute" } ) }}

Source de la révision

<p>
{{ DomRef() }}
</p>
<h3 id="R.C3.A9sum.C3.A9" name="R.C3.A9sum.C3.A9"> Résumé </h3>
<p>Ajoute un nouvel attribut ou change la valeur d'un attribut existant pour l'élément spécifié. </p>
<h3 id="Syntaxe" name="Syntaxe"> Syntaxe </h3>
<pre class="eval"><i>element</i>.setAttribute(<i>nom</i>, <i>valeur</i>);
</pre>
<ul><li> <code>nom</code> est le nom du nouvel attribut sous forme de chaîne.
</li><li> <code>valeur</code> est la nouvelle valeur désirée de l'attribut.
</li></ul>
<h3 id="Exemple" name="Exemple"> Exemple </h3>
<pre class="eval">var d = document.getElementById("d1"); 
d.setAttribute("align", "center");
</pre>
<h3 id="Notes" name="Notes"> Notes </h3>
<p>Si l'attribut spécifié existe déjà, sa valeur est modifiée en la valeur reçue en paramètre. S'il n'existe pas encore, l'attribut est créé. </p><p>Même si <code><a href="fr/DOM/element.getAttribute">getAttribute()</a></code> renvoie <code>null</code> pour les attributs manquants, il vaut mieux utiliser <code><a href="fr/DOM/element.removeAttribute">removeAttribute()</a></code> plutôt que <code><i>elt</i>.setAttribute(<i>attr</i>, null)</code> pour enlever un attribut.
</p><p>L'utilisation de <code>setAttribute()</code> pour modifier certains attributs, en particulier <code>value</code> en XUL et HTML ou <code>selected</code> en HTML, ne conduit pas toujours au résultat attendu, étant donné que l'attribut spécifie juste la valeur par défaut. Pour accéder ou modifier les valeurs courantes, il vaut mieux utiliser les propriétés correspondantes. Par exemple, utilisez <code><i>elt</i>.value</code> plutôt que <code><i>elt</i>.setAttribute('value', <i>val</i>)</code>.
</p><p>{{ DOMAttributeMethods() }}
</p>
<h3 id="Sp.C3.A9cification" name="Sp.C3.A9cification"> Spécification </h3>
<ul><li> <a class="external" href="http://www.w3.org/TR/DOM-Level-2-Core/core.html#ID-F68F082">DOM Level 2 Core : setAttribute</a> — <small><a class="external" href="http://www.yoyodesign.org/doc/w3c/dom2/core/core.html#ID-F68F082">traduction en français</a> (non normative)</small>
</li><li> Cette méthode a fait son apparition dans <a class="external" href="http://www.w3.org/TR/REC-DOM-Level-1/level-one-core.html#method-setAttribute">DOM Level 1 Core</a>
</li></ul>
<div class="noinclude">
</div>
{{ languages( { "en": "en/DOM/element.setAttribute", "ja": "ja/DOM/element.setAttribute", "pl": "pl/DOM/element.setAttribute" } ) }}
Revenir à cette révision