diff options
author | SphinxKnight <SphinxKnight@users.noreply.github.com> | 2021-10-04 07:35:29 +0200 |
---|---|---|
committer | GitHub <noreply@github.com> | 2021-10-04 07:35:29 +0200 |
commit | e8f3f2a9b6c413833dcae5d722d62ed3405f2f7b (patch) | |
tree | afa4afd50111a1376d79bc48c572f1ae7754bc91 /files/fr | |
parent | 9a626c91061f9349b2e4116bff5c9af4e1b90d92 (diff) | |
download | translated-content-e8f3f2a9b6c413833dcae5d722d62ed3405f2f7b.tar.gz translated-content-e8f3f2a9b6c413833dcae5d722d62ed3405f2f7b.tar.bz2 translated-content-e8f3f2a9b6c413833dcae5d722d62ed3405f2f7b.zip |
Convert page to MD for current PR (#2394)
With commits squashed from @audrasjb
Diffstat (limited to 'files/fr')
-rw-r--r-- | files/fr/web/api/domtokenlist/toggle/index.md | 57 |
1 files changed, 27 insertions, 30 deletions
diff --git a/files/fr/web/api/domtokenlist/toggle/index.md b/files/fr/web/api/domtokenlist/toggle/index.md index ffc75cd1b8..d7a896ab1b 100644 --- a/files/fr/web/api/domtokenlist/toggle/index.md +++ b/files/fr/web/api/domtokenlist/toggle/index.md @@ -1,68 +1,65 @@ --- title: DOMTokenList.toggle() slug: Web/API/DOMTokenList/toggle -tags: - - API - - Basculement - - DOM - - Listes - - Méthodes translation_of: Web/API/DOMTokenList/toggle +browser-compat: api.DOMTokenList.toggle --- {{APIRef("DOM")}} -La méthode **`toggle()`** (_bascule_) de l'interface {{domxref("DOMTokenList")}} supprime une marque (_token)_ donnée de la liste et renvoie `false` (_faux_). Si _token_ n'existe pas, il est ajouté et la fonction renvoie `true`. +La méthode **`toggle()`** (qui signifie _basculer_ en anglais) de l'interface [`DOMTokenList`](/fr/docs/Web/API/DOMTokenList) supprime un jeton (_token_) donné de la liste et renvoie `false`. Si _token_ n'existe pas, il est ajouté et la fonction renvoie `true`. ## Syntaxe - tokenList.toggle(token, force); +```js +tokenList.toggle(token [, force]); +``` ### Paramètres - token - - : Une {{domxref("DOMString")}} (_chaîne de caractères_) représentant la marque que l'on veut activer. + - : Une chaîne de caractères [`DOMString`](/fr/docs/Web/API/DOMString) représentant le jeton que l'on veut activer ou désactiver. - force {{optional_inline}} - - : Un {{domxref("Boolean")}} (_booléen_) qui, si inclus, transforme la bascule (toggle) en opération unique. Si elle est définie `false` (_faux_), la marque sera seulement supprimée et aucun ajout ne suivra. Si elle est définie `true` (_vrai_), la marque sera seulement ajoutée et pas supprimée après. + - : Un _booléen_ qui, s'il est inclus, transforme la bascule en opération à un seul sens. Si ce paramètre vaut `false`, le jeton sera seulement supprimé et aucun ajout ne suivra. S'il vaut `true`, le jeton sera seulement ajouté et pas supprimé. -### Valeur retournée +### Valeur de retour -Un {{domxref("Boolean")}} (_booléen_) — `false` (_faux_) si la marque n'est pas dans la liste après l'appel ou `true` (_vrai_) si elle y est. +Un booléen qui vaut `true` ou `false` selon que le jeton se trouve dans la liste après l'exécution de la fonction ou non. ## 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 une marque dans la liste et écrivons la liste dans le {{domxref("Node.textContent")}} du `<span>`. +Dans l'exemple suivant, nous récupérons la liste des classes définies dans un élément [`<span>`](/fr/docs/Web/HTML/Element/span) en tant que `DOMTokenList` en utilisant [`Element.classList`](/fr/docs/Web/API/Element/classList). Lors d'un clic sur le texte, nous remplaçons alors un jeton dans la liste et écrivons la liste dans le [`Node.textContent`](/fr/docs/Web/API/Node/textContent) du `<span>`. -D'abord, le HTML : +### HTML ```html -<span class="a b">classList is 'a b'</span> +<span class="a b">classList vaut 'a b'</span> ``` -Maintenant le JavaScript : +### JavaScript ```js -var span = document.querySelector("span"); -var classes = span.classList; -span.onclick = function() { - var result = classes.toggle("c"); - if(result) { - span.textContent = "'c' added; classList is now '" + classes + "'."; +let span = document.querySelector("span"); +let classes = span.classList; + +span.addEventListener('click', function() { + let result = classes.toggle("c"); + + if (result) { + span.textContent = `'c' ajouté ; classList vaut désormais "${classes}".`; } else { - span.textContent = "'c' removed; classList is now '" + classes + "'."; + span.textContent = `'c' retiré ; classList vaut désormais "${classes}".`; } -} +}) ``` -La sortie ressemble à ceci : +### Résultat -{{ EmbedLiveSample('Examples', '100%', 60) }} +{{EmbedLiveSample('Exemples', '100%', 60)}} ## Spécifications -| Spécification | Statut | Commentaire | -| ------------------------------------------------------------------------------------ | -------------------------------- | -------------------- | -| {{SpecName('DOM WHATWG','#dom-domtokenlist-toggle','toggle()')}} | {{Spec2('DOM WHATWG')}} | Définition initiale. | +{{Specifications}} ## Compatibilité des navigateurs -{{Compat("api.DOMTokenList.toggle")}} +{{Compat}} |