element.getAttribute

  • Raccourci de la révision : DOM/element.getAttribute
  • Titre de la révision : element.getAttribute
  • ID de la révision : 167382
  • Créé :
  • Créateur : BenoitL
  • Version actuelle ? Non
  • Commentaire mise à jour

Contenu de la révision

{{template.DomRef()}}

Résumé

getAttribute renvoie la valeur d'un attribut donné de l'élément spécifié. Si l'attribut n'existe pas, la valeur renvoyée sera soit null soit "" (une chaîne vide) ; voir {{template.Anch("Notes")}} pour plus de détails.

Syntaxe

attribut = element.getAttribute(nom_attribut)

  • attribut est une chaîne contenant la valeur de l'attribut nom_attribut.
  • nom_attribut est le nom de l'attribut dont on désire connaître la valeur.

Exemple

var div1 = document.getElementById("div1");
var align = div1.getAttribute("align");
alert(align); // affiche la valeur de l'attribut align pour l'élément dont l'id="div1"

Notes

À peu près tous les navigateurs (Firefox, Internet Explorer, Opera, Safari, Konqueror, et iCab, sans que cette liste soit exhaustive) renvoient null lorsque l'attribut demandé n'existe pas sur l'élément spécifié. La spécification DOM indique cependant que la valeur de retour correcte dans ce cas est en fait la chaîne vide, et certaines implémentation DOM auront ce comportement. Par conséquent, vous devriez utiliser hasAttribute pour vérifier l'existence d'un attribut avant d'appeler getAttribute() s'il est possible que l'attribut n'existe pas sur l'élément spécifié.

Le paramètre nom_attribut est généralement sensible à la casse, mais ne l'est pas lorsqu'il est utilisé sur des éléments HTML.

{{template.DOMAttributeMethods()}}

Spécification

{{ wiki.languages( { "en": "en/DOM/element.getAttribute", "pl": "pl/DOM/element.getAttribute" } ) }}

Source de la révision

<p>
{{template.DomRef()}}
</p>
<h3 name="R.C3.A9sum.C3.A9"> Résumé </h3>
<p><code>getAttribute</code> renvoie la valeur d'un attribut donné de l'élément spécifié. Si l'attribut n'existe pas, la valeur renvoyée sera soit <code>null</code> soit <code>""</code> (une chaîne vide) ; voir {{template.Anch("Notes")}} pour plus de détails.
</p>
<h3 name="Syntaxe"> Syntaxe </h3>
<pre class="eval"><i>attribut</i> = element.getAttribute(<i>nom_attribut</i>)
</pre>
<p>où
</p>
<ul><li> <code><i>attribut</i></code> est une chaîne contenant la valeur de l'attribut <code><i>nom_attribut</i></code>.
</li><li> <code><i>nom_attribut</i></code> est le nom de l'attribut dont on désire connaître la valeur.
</li></ul>
<h3 name="Exemple"> Exemple </h3>
<pre class="eval">var div1 = document.getElementById("div1");
var align = div1.getAttribute("align");
alert(align); // affiche la valeur de l'attribut align pour l'élément dont l'id="div1"
</pre>
<h3 name="Notes"> Notes </h3>
<p>À peu près tous les navigateurs (Firefox, Internet Explorer, Opera, Safari, Konqueror, et iCab, sans que cette liste soit exhaustive) renvoient <code>null</code> lorsque l'attribut demandé n'existe pas sur l'élément spécifié. La spécification DOM indique cependant que la valeur de retour correcte dans ce cas est en fait la <i>chaîne vide</i>, et certaines implémentation DOM auront ce comportement. Par conséquent, vous devriez utiliser <a href="fr/DOM/element.hasAttribute">hasAttribute</a> pour vérifier l'existence d'un attribut avant d'appeler <code>getAttribute()</code> s'il est possible que l'attribut n'existe pas sur l'élément spécifié.
</p><p>Le paramètre <code>nom_attribut</code> est généralement sensible à la casse, mais ne l'est pas lorsqu'il est utilisé sur des éléments HTML.
</p><p>{{template.DOMAttributeMethods()}}
</p>
<h3 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-666EE0F9">DOM Level 2 Core : getAttribute</a> — <small><a class="external" href="http://www.yoyodesign.org/doc/w3c/dom2/core/core.html#ID-666EE0F9">traduction en français</a> (non normative)</small>
</li><li> Cette méthode est apparue dans <a class="external" href="http://www.w3.org/TR/REC-DOM-Level-1/level-one-core.html#method-getAttribute">DOM Level 1 Core</a>
</li></ul>
{{ wiki.languages( { "en": "en/DOM/element.getAttribute", "pl": "pl/DOM/element.getAttribute" } ) }}
Revenir à cette révision