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/element/getattribute | |
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/element/getattribute')
-rw-r--r-- | files/fr/web/api/element/getattribute/index.html | 85 |
1 files changed, 85 insertions, 0 deletions
diff --git a/files/fr/web/api/element/getattribute/index.html b/files/fr/web/api/element/getattribute/index.html new file mode 100644 index 0000000000..5c50b4cd64 --- /dev/null +++ b/files/fr/web/api/element/getattribute/index.html @@ -0,0 +1,85 @@ +--- +title: element.getAttribute +slug: Web/API/Element/getAttribute +tags: + - API + - DOM + - Element + - Method + - Méthode + - Reference +translation_of: Web/API/Element/getAttribute +--- +<p>{{APIRef("DOM")}}</p> + +<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 chaine vide) ; voir {{ Anch("Notes") }} pour plus de détails.</p> + +<h2 id="Syntaxe" name="Syntaxe">Syntaxe</h2> + +<pre class="eval notranslate"><em>let attribut</em> = element.getAttribute(<em>nom_attribut</em>) +</pre> + +<p>où</p> + +<ul> + <li><code><em>attribut</em></code> est une chaine contenant la valeur de l'attribut <code><em>nom_attribut</em></code>.</li> + <li><code><em>nom_attribut</em></code> est le nom de l'attribut dont on désire connaitre la valeur.</li> +</ul> + +<h2 id="Exemple" name="Exemple">Exemple</h2> + +<p>Soit l'HTML :</p> + +<pre class="notranslate">const div1 = document.getElementById("div1");</pre> + +<p>Exemple de JavaScript :</p> + +<pre class="eval notranslate">const div1 = document.getElementById("div1"); +//=> <div id="div1">Hi Champ!</div> + +const attributID = div1.getAttribute("id"); +//=> "div1" + +cont alignement = div1.getAttribute("align"); +//=> null +</pre> + +<h2 id="Notes" name="Notes">Description</h2> + +<h3 id="Sensibilité_à_la_casse">Sensibilité à la casse</h3> + +<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> + +<h3 id="Attributs_inexistants">Attributs inexistants</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 chaine vide <code>""</code>, et certaines implémentation DOM auront ce comportement. Par conséquent, vous devriez utiliser {{domxref("element.hasAttribute()")}} 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> + +<h3 id="Récupération_de_nonces">Récupération de nonces</h3> + +<p>Pour des raisons de sécurité, les <em>nonces</em> <a href="/fr/docs/Web/HTTP/CSP">CSP</a> des sources autres que des scripts, telles que les feuilles de style CSS, et les appels <code>.getAttribute("nonce")</code> sont interdits.</p> + +<pre class="brush: js example-bad notranslate">let nonce = script.getAttribute("nonce"); +// renvoie une chaine vide</pre> + +<p>Plutôt que de tenter de lire le <em>nonce</em> via l’attribut, utilisez la propriété {{domxref("HTMLOrForeignElement/nonce", "nonce")}} :</p> + +<pre class="brush: js notranslate">let nonce = script.nonce;</pre> + +<h2 id="Sp.C3.A9cification" name="Sp.C3.A9cification">Spécifications</h2> + +<table class="standard-table"> + <tbody> + <tr> + <td><strong>Spécification</strong></td> + <td><strong>État</strong></td> + </tr> + <tr> + <td>{{SpecName('DOM WHATWG','#dom-element-getattribute','getAttribute()')}}</td> + <td>{{Spec2('DOM WHATWG')}}</td> + </tr> + </tbody> +</table> + +<h2 id="Sp.C3.A9cification" name="Sp.C3.A9cification">Compatibilité des navigateurs</h2> + +<div>{{Compat("api.Element.getAttribute")}}</div> |