blob: a352208494c5f427459eeffbf13424312b161d1f (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
|
---
title: DOMTokenList.replace()
slug: Web/API/DOMTokenList/replace
tags:
- API
- DOM
- Listes
- Méthodes
- Remplacement
translation_of: Web/API/DOMTokenList/replace
---
{{APIRef("DOM")}}
La méthode **`replace()`** de l'interface {{domxref("DOMTokenList")}} remplace une marque _(token)_ existante par une nouvelle marque.
## Syntaxe
tokenList.replace(oldToken,newToken);
### Paramètres
- oldToken
- : Une {{domxref("DOMString")}} (_chaîne de caractères_) représentant la marque que vous voulez remplacer.
- newToken
- : Une {{domxref("DOMString")}} (_chaîne de caractères_) représentant la marque avec laquelle vous voulez remplacer l'ancienne.
### Valeur retournée
Vide.
## Exemples
Dans l'exemple suivant, nous récupérons la liste des classes définies dans un élément {{htmlelement("span")}} en tant que `DOMTokenList` en utilisant {{domxref("Element.classList")}}. Nous remplaçons alors la marque dans la liste et écrivons la liste dans le {{domxref("Node.textContent")}} du `<span>`.
D'abord, le HTML :
```html
<span class="a b c"></span>
```
Maintenant le JavaScript :
```js
var span = document.querySelector("span");
var classes = span.classList;
try {
classes.replace("c", "z");
span.textContent = classes;
} catch(e) {
span.textContent = e;
}
```
La sortie ressemble à ceci :
{{ EmbedLiveSample('Examples', '100%', 60) }}
## Spécifications
| Spécification | Statut | Commentaire |
| ---------------------------------------------------------------------------------------- | -------------------------------- | ------------------- |
| {{SpecName('DOM WHATWG','#dom-domtokenlist-replace','replace()')}} | {{Spec2('DOM WHATWG')}} | Définition initiale |
## Compatibilité des navigateurs
{{Compat("api.DOMTokenList.replace")}}
|
