Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[fr] fix: Updates to Web/API/Element/*Attribute* pages #19512

Merged
merged 15 commits into from Apr 17, 2024
35 changes: 26 additions & 9 deletions files/fr/web/api/element/getattributenode/index.md
Expand Up @@ -5,8 +5,6 @@ slug: Web/API/Element/getAttributeNode

{{ APIRef("DOM") }}

## Résumé

Renvoie le nœud d'attribut spécifié pour l'élément courant, en tant que noeud `Attr`.

## Syntaxe
Expand All @@ -15,8 +13,15 @@ Renvoie le nœud d'attribut spécifié pour l'élément courant, en tant que noe
var attrNode = element.getAttributeNode(attrName);
```

- `attrNode` est un nœud `Attr` pour l'attribut demandé.
- `attrName` est une chaîne de caractères qui contient le nom de l'attribut.
### Paramètre

- `attrName`
- : est une chaîne de caractères qui contient le nom de l'attribut.

### Valeur de retour

- `attrNode`
- : est un nœud `Attr` pour l'attribut demandé.

## Exemple

Expand All @@ -31,11 +36,23 @@ alert(idAttr.value == "top");

Lorsqu'elle est appelée sur un élément HTML dans un DOM marqué comme un document HTML, `getAttributeNode` passe en minuscules son argument avant de continuer.

Les nœuds `Attr` héritent de `Node`, mais ne sont pas considérés comme faisant partie de l'arbre du document. Les attributs habituels des nœuds comme [parentNode](/fr/DOM/element.parentNode), [previousSibling](/fr/DOM/element.previousSibling), et [nextSibling](/fr/DOM/element.nextSibling) sont `null` pour un nœud `Attr`. Vous pouvez cependant accéder à l'élément auquel cet attribut appartient grâce à la propriété `ownerElement`.
Les nœuds `Attr` héritent de `Node`, mais ne sont pas considérés comme faisant partie de l'arbre du document. Les attributs habituels des nœuds comme [parentNode](/fr/docs/Web/API/Node/parentNode), [previousSibling](/fr/docs/Web/API/Node/previousSibling), et [nextSibling](/fr/docs/Web/API/Node/nextSibling) sont `null` pour un nœud `Attr`. Vous pouvez cependant accéder à l'élément auquel cet attribut appartient grâce à la propriété `ownerElement`.

[getAttribute](/fr/docs/Web/API/Element/getAttribute) est habituellement utilisé à la place de `getAttributeNode` pour obtenir la valeur d'un attribut d'un élément.

## Spécifications

{{Specifications}}

- [DOM Level 2 Core : getAttributeNode](https://www.w3.org/TR/DOM-Level-2-Core/core.html#ID-217A91B8) — [traduction en français](http://www.yoyodesign.org/doc/w3c/dom2-core/core.html#ID-217A91B8) (non normative)
- [HTML 5: APIs in HTML documents](https://www.whatwg.org/specs/web-apps/current-work/multipage/dom.html#apis-in-html-documents)

## Compatibilité des navigateurs

[getAttribute](/fr/DOM/element.getAttribute) est habituellement utilisé à la place de `getAttributeNode` pour obtenir la valeur d'un attribut d'un élément.
{{Compat}}

## Spécification
## Voir aussi

- [DOM Level 2 Core : getAttributeNode](http://www.w3.org/TR/DOM-Level-2-Core/core.html#ID-217A91B8) — [traduction en français](http://www.yoyodesign.org/doc/w3c/dom2-core/core.html#ID-217A91B8) (non normative)
- [HTML 5: APIs in HTML documents](http://www.whatwg.org/specs/web-apps/current-work/multipage/dom.html#apis-in-html-documents)
- [`Document.createAttribute()`](/fr/docs/Web/API/Document/createAttribute)
- [`Element.setAttributeNode()`](/fr/docs/Web/API/Element/setAttributeNode)
- [`Element.removeAttributeNode()`](/fr/docs/Web/API/Element/removeAttributeNode)
33 changes: 22 additions & 11 deletions files/fr/web/api/element/getattributenodens/index.md
Expand Up @@ -3,33 +3,44 @@ title: element.getAttributeNodeNS
slug: Web/API/Element/getAttributeNodeNS
---

{{ ApiRef() }}

### Résumé
{{ APIRef("DOM") }}

Renvoie le nœud `Attr` pour l'attribut avec l'espace de noms et le nom donnés.

### Syntaxe
## Syntaxe

```js
attributeNode = element.getAttributeNodeNS(namespace, nodeName);
```

### Paramètres

- `attributeNode`
- : Le nœud pour l'attribut spécifié.
- `namespace`
- : Une chaîne spécifiant l'espace de noms de l'attribut.
- `nodeName`
- : Une chaîne spécifiant le nom de l'attribut.

\== Example == TBD The example needs to be fixed // html: \<div id="top" /> t = document.getElementById("top"); specialNode = t.getAttributeNodeNS( "<http://www.mozilla.org/ns/specialspace>", "id"); // iNode.value = "full-top"
### Valeur de retour

- `attributeNode`
- : Le nœud pour l'attribut spécifié.

## Notes

`getAttributeNodeNS` est plus spécifique que [`Element.getAttributeNode()`](/fr/docs/Web/API/Element/getAttributeNode) car il permet de spécifier les attributs faisant partis d'un espace de noms particulier. La méthode de réglage correspondante est [`Element.setAttributeNodeNS()`](/fr/docs/Web/API/Element/setAttributeNodeNS).

## Spécifications

{{Specifications}}

- [DOM Level 2 Core: getAttributeNodeNS (en)](https://www.w3.org/TR/DOM-Level-2-Core/core.html#ID-ElGetAtNodeNS) — [traduction en français](http://www.yoyodesign.org/doc/w3c/dom2-core/core.html#ID-ElGetAtNodeNS) (non normative)

### Notes
## Compatibilité des navigateurs

`getAttributeNodeNS` est plus spécifique que {{ domxref("Element.getAttributeNode") }} en ce qu'il permet de spécifier les attributs faisant partis d'un espace de noms particulier. La méthode de réglage correspondante est {{ domxref("Element.setAttributeNodeNS") }}.
{{Compat}}

### Spécification
## Voir aussi

- [DOM Level 2 Core: getAttributeNodeNS (en)](http://www.w3.org/TR/DOM-Level-2-Core/core.html#ID-ElGetAtNodeNS) — [traduction en français](http://www.yoyodesign.org/doc/w3c/dom2-core/core.html#ID-ElGetAtNodeNS) (non normative)
- [`Document.createAttribute()`](/fr/docs/Web/API/Document/createAttribute)
- [`Document.createAttributeNS()`](/fr/docs/Web/API/Document/createAttributeNS)
- [`Element.setAttributeNodeNS()`](/fr/docs/Web/API/Element/setAttributeNodeNS)
13 changes: 8 additions & 5 deletions files/fr/web/api/element/getattributens/index.md
Expand Up @@ -5,7 +5,7 @@ slug: Web/API/Element/getAttributeNS

{{APIRef("DOM")}}

**`getAttributeNS()`** est une méthode de l'interface {{domxref("Element")}} qui renvoie la valeur chaîne de l'attribut avec l'espace de noms et le nom donnés. Si l'attribut nommé n'existe pas, cette valeur sera soit `null`, soit `""` (une chaîne vide)&nbsp;; voir la section [Notes](#notes) pour plus de détails.
**`getAttributeNS()`** est une méthode de l'interface [`Element`](/fr/docs/Web/API/Element) qui renvoie la valeur chaîne de l'attribut avec l'espace de noms et le nom donnés. Si l'attribut nommé n'existe pas, cette valeur sera soit `null`, soit `""` (une chaîne vide)&nbsp;; voir la section [Notes](#notes) pour plus de détails.

## Syntaxe

Expand All @@ -22,7 +22,8 @@ attrVal = element.getAttributeNS(namespace, name);

### Valeur de retour

La valeur de chaîne de caractères de l'attribut spécifié. Si l'attribut n'existe pas, le résultat est `null`.
- `attrVal`
- : La valeur de chaîne de caractères de l'attribut spécifié. Si l'attribut n'existe pas, le résultat est `null`.

> **Note :** Les versions antérieures de la spécification DOM avaient cette méthode décrite comme renvoyant une chaîne vide pour des attributs inexistants, mais elle n'était généralement pas implémentée de cette façon, car null a plus de sens. La spécification DOM4 indique maintenant que cette méthode devrait retourner null pour les attributs inexistants.

Expand Down Expand Up @@ -81,9 +82,9 @@ Dans un document HTML5, il faut utiliser `test:foo` pour accéder à l'attribut

Les espaces de noms sont uniquement pris en charge dans les documents XML, Les documents HTML5 doivent utiliser à la place `getAttribute()` .

La méthode `getAttributeNS` diffère de {{domxref("element.getAttribute()", "getAttribute()")}} en ce qu'elle permet de spécifier les attributs faisant partie d'un espace de noms particulier, comme dans l'exemple précédent, où l'attribut fait partie d'un espace de noms fictif «&nbsp;specialspace&nbsp;» de mozilla.
La méthode `getAttributeNS` diffère de [`getAttribute()`](/fr/docs/Web/API/Element/getAttribute) en ce qu'elle permet de spécifier les attributs faisant partie d'un espace de noms particulier, comme dans l'exemple précédent, où l'attribut fait partie d'un espace de noms fictif «&nbsp;specialspace&nbsp;» de mozilla.

Avant la spécification DOM4, cette méthode était spécifiée pour renvoyer une chaîne vide plutôt que null pour les attributs inexistants. Cependant, la plupart des navigateurs ont renvoyé null. À partir de DOM4, la spécification dit maintenant de retourner null. Cependant, certains navigateurs plus anciens renvoient une chaîne vide. Pour cette raison, vous devez utiliser {{domxref("element.hasAttributeNS ()","hasAttributeNS ()")}} pour vérifier l'existence d'un attribut avant d'appeler `getAttributeNS()` s'il est possible que l'attribut demandé n'existe pas sur l'élément spécifié.
Avant la spécification DOM4, cette méthode était spécifiée pour renvoyer une chaîne vide plutôt que null pour les attributs inexistants. Cependant, la plupart des navigateurs ont renvoyé null. À partir de DOM4, la spécification dit maintenant de retourner null. Cependant, certains navigateurs plus anciens renvoient une chaîne vide. Pour cette raison, vous devez utiliser [`hasAttributeNS()`](/fr/docs/Web/API/Element/hasAttributeNS) pour vérifier l'existence d'un attribut avant d'appeler `getAttributeNS()` s'il est possible que l'attribut demandé n'existe pas sur l'élément spécifié.

## Spécifications

Expand All @@ -95,4 +96,6 @@ Avant la spécification DOM4, cette méthode était spécifiée pour renvoyer un

## Voir aussi

- [Code snippets:getAttributeNS](/fr/Add-ons/Code_snippets/getAttributeNS)
- [`Element.hasAttributeNS()`](/fr/docs/Web/API/Element/hasAttributeNS)
- [`Element.setAttributeNS()`](/fr/docs/Web/API/Element/setAttributeNS)
- [`Element.removeAttributeNS()`](/fr/docs/Web/API/Element/removeAttributeNS)
17 changes: 15 additions & 2 deletions files/fr/web/api/element/hasattribute/index.md
Expand Up @@ -13,11 +13,16 @@ La méthode **`Element.hasAttribute()`** renvoie une **valeur booléenne** indiq
var result = element.hasAttribute(name);
```

- `result`
- : récupère la valeur de retour `true` ou `false`.
### Paramètre

- `name`
- : est une chaine de caractères représentant le nom de l'attribut.

### Valeur de retour

- `result`
- : récupère la valeur de retour `true` ou `false`.

## Exemple

```js
Expand Down Expand Up @@ -46,3 +51,11 @@ if (foo.hasAttribute("bar")) {
## Compatibilité des navigateurs

{{Compat}}

## Voir aussi

- [`Element.hasAttributes()`](/fr/docs/Web/API/Element/hasAttributes)
- [`Element.getAttribute()`](/fr/docs/Web/API/Element/getAttribute)
- [`Element.setAttribute()`](/fr/docs/Web/API/Element/setAttribute)
- [`Element.removeAttribute()`](/fr/docs/Web/API/Element/removeAttribute)
- [`Element.toggleAttribute()`](/fr/docs/Web/API/Element/toggleAttribute)
29 changes: 22 additions & 7 deletions files/fr/web/api/element/hasattributens/index.md
Expand Up @@ -5,23 +5,26 @@ slug: Web/API/Element/hasAttributeNS

{{ APIRef("DOM") }}

## Résumé

`hasAttributeNS` renvoie une valeur booléenne indiquant si l'élément courant possède ou non l'attribut spécifié.

## Syntaxe

```js
result = element.hasAttributeNS(namespace, localName);
var result = element.hasAttributeNS(namespace, localName);
```

- `result`
- : Une valeur booléenne `true` ou `false`.
### Paramètres

- `namespace`
- : Une chaîne spécifiant l'espace de noms de l'attribut.
- `localName`
- : Le nom de l'attribut.

### Valeur de retour

- `result`
- : Une valeur booléenne `true` ou `false`.

## Exemple

```js
Expand All @@ -35,6 +38,18 @@ if (
}
```

## Spécification
## Spécifications

{{Specifications}}

- [DOM Level 2 Core: hasAttributeNS (en)](https://www.w3.org/TR/DOM-Level-2-Core/core.html#ID-ElHasAttrNS) — [traduction en français](http://www.yoyodesign.org/doc/w3c/dom2-core/core.html#ID-ElHasAttrNS) (non normative)

## Compatibilité des navigateurs

{{Compat}}

## Voir aussi

- [DOM Level 2 Core: hasAttributeNS (en)](http://www.w3.org/TR/DOM-Level-2-Core/core.html#ID-ElHasAttrNS) — [traduction en français](http://www.yoyodesign.org/doc/w3c/dom2-core/core.html#ID-ElHasAttrNS) (non normative)
- [`Element.getAttributeNS()`](/fr/docs/Web/API/Element/getAttributeNS)
- [`Element.setAttributeNS()`](/fr/docs/Web/API/Element/setAttributeNS)
- [`Element.removeAttributeNS()`](/fr/docs/Web/API/Element/removeAttributeNS)
13 changes: 10 additions & 3 deletions files/fr/web/api/element/removeattribute/index.md
Expand Up @@ -13,14 +13,14 @@ La méthode **`removeAttribute()`**, rattachée à l'interface [`Element`](/fr/d
element.removeAttribute(nomAttribut);
```

### Paramètres
### Paramètre

- `nomAttribut`
- : Une chaîne de caractères ([`DOMString`](/fr/docs/Web/API/DOMString)) qui indique le nom de l'attribut à supprimer de l'élément. Si l'attribut indiqué n'existe pas, `removeAttribute()` finit son exécution sans générer d'erreur.
- : Une chaîne de caractères ([`DOMString`](/fr/docs/Web/JavaScript/Reference/Global_Objects/String)) qui indique le nom de l'attribut à supprimer de l'élément. Si l'attribut indiqué n'existe pas, `removeAttribute()` finit son exécution sans générer d'erreur.

### Valeur de retour

`undefined`.
[`undefined`](/fr/docs/Web/JavaScript/Reference/Global_Objects/undefined).

## Notes d'utilisation

Expand All @@ -41,3 +41,10 @@ document.getElementById("div1").removeAttribute("align");
## Compatibilité des navigateurs

{{Compat}}

## Voir aussi

- [`Element.hasAttribute()`](/fr/docs/Web/API/Element/hasAttribute)
- [`Element.getAttribute()`](/fr/docs/Web/API/Element/getAttribute)
- [`Element.setAttribute()`](/fr/docs/Web/API/Element/setAttribute)
- [`Element.toggleAttribute()`](/fr/docs/Web/API/Element/toggleAttribute)
27 changes: 23 additions & 4 deletions files/fr/web/api/element/removeattributenode/index.md
Expand Up @@ -13,8 +13,15 @@ slug: Web/API/Element/removeAttributeNode
removedAttr = element.removeAttributeNode(attributeNode);
```

- `attributeNode` est le nœud `Attr` à enlever.
- `removedAttr` est le nœud `Attr` qui vient d'être enlevé.
### Paramètre

- `attributeNode`
- : est le nœud `Attr` à enlever.

### Valeur de retour

- `removedAttr`
- : est le nœud `Attr` qui vient d'être enlevé.

## Exemple

Expand All @@ -32,6 +39,18 @@ Si l'attribut enlevé a une valeur par défaut, celle-ci remplace immédiatement

Il n'y a pas de `removeAttributeNodeNS` (contrairement à la paire `setAttributeNode` et `setAttributeNodeNS` pour lesquels il est nécessaire de savoir quel attribut remplacer (le cas échéant), `removeAttributeNode` n'a pas cette exigence. `removeAttributeNode` peut supprimer des attributs, qu'ils soient d'espace de noms ou pas.

## Spécification
## Spécifications

{{Specifications}}

- [DOM Level 2 Core&nbsp;: removeAttributeNode](https://www.w3.org/TR/DOM-Level-2-Core/core.html#ID-D589198) — [traduction en français](http://www.yoyodesign.org/doc/w3c/dom2-core/core.html#ID-D589198) (non normative)

## Compatibilité des navigateurs

{{Compat}}

## Voir aussi

- [DOM Level 2 Core&nbsp;: removeAttributeNode](http://www.w3.org/TR/DOM-Level-2-Core/core.html#ID-D589198) — [traduction en français](http://www.yoyodesign.org/doc/w3c/dom2-core/core.html#ID-D589198) (non normative)
- [`Document.createAttribute()`](/fr/docs/Web/API/Document/createAttribute)
- [`Element.getAttributeNode()`](/fr/docs/Web/API/Element/getAttributeNode)
- [`Element.setAttributeNode()`](/fr/docs/Web/API/Element/setAttributeNode)
28 changes: 24 additions & 4 deletions files/fr/web/api/element/removeattributens/index.md
Expand Up @@ -15,8 +15,16 @@ Dans Firefox 3 et postérieurs, cette méthode réinitialise les valeurs DOM à
element.removeAttributeNS(namespace, attrName);
```

- `namespace` est une chaîne qui contient l'espace de noms de l'attribut.
- `attrName` est une chaîne qui nomme l'attribut à supprimer du noeud en cours.
### Paramètres

- `namespace`
- : est une chaîne qui contient l'espace de noms de l'attribut.
quentin-rey marked this conversation as resolved.
Show resolved Hide resolved
- `attrName`
- : est une chaîne qui nomme l'attribut à supprimer du noeud en cours.

### Valeur de retour

[`undefined`](/fr/docs/Web/JavaScript/Reference/Global_Objects/undefined).

## Exemple

Expand All @@ -28,6 +36,18 @@ d.removeAttributeNS("http://www.mozilla.org/ns/specialspace", "specialAlign");
// l'élément est devenu&nbsp;: <div id="div1" width="200px" />
```

## Spécification
## Spécifications

{{Specifications}}

- [DOM Level 2 Core: removeAttributeNS (en)](https://www.w3.org/TR/DOM-Level-2-Core/core.html#ID-ElRemAtNS) — [traduction en français](http://www.yoyodesign.org/doc/w3c/dom2-core/core.html#ID-ElRemAtNS) (non normative)

## Compatibilité des navigateurs

{{Compat}}

## Voir aussi

- [DOM Level 2 Core: removeAttributeNS (en)](http://www.w3.org/TR/DOM-Level-2-Core/core.html#ID-ElRemAtNS) — [traduction en français](http://www.yoyodesign.org/doc/w3c/dom2-core/core.html#ID-ElRemAtNS) (non normative)
- [`Element.hasAttributeNS()`](/fr/docs/Web/API/Element/hasAttributeNS)
- [`Element.getAttributeNS()`](/fr/docs/Web/API/Element/getAttributeNS)
- [`Element.setAttributeNS()`](/fr/docs/Web/API/Element/setAttributeNS)