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

CKTIS / CSS

:indeterminate — pseudo-classe d’état indéterminé

La pseudo-classe :indeterminate correspond aux contrôles dans un état indéterminé : cases à cocher configurées en conséquence, boutons radio d’un groupe sans sélection et éléments progress sans attribut value. Elle ne signifie pas simplement « non coché ».

Version : CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required

Syntaxe

:indeterminate

:indeterminate est une pseudo-classe d’état, et non un pseudo-élément. Elle permet de styliser un contrôle existant dont l’état est indéterminé. La forme input:indeterminate limite la sélection aux éléments input ; :indeterminate seul inclut aussi les éléments progress correspondants.

La norme HTML définit trois cas : un input de type checkbox dont la propriété indeterminate vaut true et qui n’a pas d’attribut switch ; chaque bouton radio dont le groupe ne contient aucun bouton coché ; et un élément progress sans attribut value. Dans un groupe radio, tous les boutons sont concernés, pas seulement un. Un élément progress avec value="0" a déjà une valeur déterminée et ne correspond pas.

Un navigateur qui ne prend pas en charge l’attribut switch peut l’ignorer. Dans ce cas, une case à cocher munie de cet attribut peut tout de même correspondre à :indeterminate si sa propriété indeterminate vaut true.

Pour une case à cocher, définissez indeterminate avec JavaScript. Cette propriété est indépendante de checked : la définir seule ne modifie pas l’état coché. Ne confondez donc pas :indeterminate avec « non coché » ni avec :not(:checked). CSS sélectionne l’état, mais ne le définit pas.

L’exemple relève les éléments correspondants, puis supprime l’état indéterminé de la case à cocher, coche un bouton radio et fixe la progression à zéro. La seconde liste est vide. L’exemple n’utilise pas l’attribut switch et ne teste pas cette exception. Le résultat attendu concerne le texte, et non l’apparence des contrôles natifs ; l’exemple doit encore être vérifié localement dans le navigateur cible.

Exemples

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>:indeterminate demo</title>
<style>
  :indeterminate { outline: 3px solid #b45309; outline-offset: 3px; }
</style>
<label><input id="box" type="checkbox"> Mixed selection</label>
<fieldset>
  <legend>Choose one</legend>
  <label><input id="a" type="radio" name="choice"> A</label>
  <label><input id="b" type="radio" name="choice"> B</label>
</fieldset>
<label>Progress <progress id="task"></progress></label>
<pre id="result"></pre>
<script>
  const box = document.getElementById('box');
  const a = document.getElementById('a');
  const task = document.getElementById('task');
  const result = document.getElementById('result');
  const matches = () => Array.from(
    document.querySelectorAll(':indeterminate'), element => element.id
  ).join(', ') || '(none)';

  box.indeterminate = true;
  const before = matches();
  box.indeterminate = false;
  a.checked = true;
  task.value = 0;
  result.textContent = before + '\n' + matches();
</script>
</html>

Résultat

box, a, b, task
(none)

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