Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / HTML

switch — un commutateur pour input

Dans les navigateurs qui le prennent en charge, l’attribut booléen switch transforme un input de type checkbox en commutateur à deux états. Son état activé ou désactivé reste déterminé par checked.

Version : Nonstandard browser extension; not defined by the WHATWG HTML Living Standard.

Syntaxe

<input type="checkbox" switch>

switch s’applique à input avec type="checkbox" ; ce n’est pas un type de champ distinct. Le commutateur a deux états, activé et désactivé, déterminés par checked. Lorsque le navigateur applique switch, indeterminate ne fournit pas de troisième état. Si le navigateur ignore switch, le contrôle reste une case à cocher ordinaire et indeterminate peut modifier son apparence.

Il s’agit d’un attribut booléen : les formes valides sont switch, switch="" et switch="switch". Pour le désactiver, supprimez l’attribut. Écrire switch="false" est incorrect et signifie tout de même que l’attribut est présent. Supprimer switch n’équivaut pas à définir checked sur false.

Dans l’exemple, un libellé décrit le contrôle et le texte en dessous affiche checked. Vérifiez séparément le rendu du commutateur dans le navigateur cible ; le résultat textuel seul ne confirme pas la prise en charge de switch.

Exemples

<!doctype html>
<meta charset="utf-8">
<title>Switch</title>
<label><input id="setting" type="checkbox" switch checked> Notifications</label>
<pre id="result"></pre>
<script>
  const setting = document.getElementById('setting');
  const result = document.getElementById('result');
  function render() {
    result.textContent = String(setting.checked);
  }
  setting.addEventListener('change', render);
  render();
</script>

Résultat

true

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources