Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / CSS

:indeterminate — pseudoklasa stanu nieokreślonego

Pseudoklasa :indeterminate dopasowuje kontrolki o stanie nieokreślonym: odpowiednio ustawione pola wyboru, przyciski radiowe w grupie bez zaznaczenia oraz elementy progress bez atrybutu value. Nie oznacza po prostu „niezaznaczony”.

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

Składnia

:indeterminate

:indeterminate jest pseudoklasą stanu, a nie pseudoelementem. Pozwala stylować istniejącą kontrolkę, której stan jest nieokreślony. Zapis input:indeterminate ogranicza dopasowanie do elementów input; samo :indeterminate obejmuje również pasujące elementy progress.

Standard HTML określa trzy przypadki dopasowania: pole input typu checkbox z właściwością indeterminate równą true i bez atrybutu switch; każdy przycisk radio, którego grupa nie zawiera zaznaczonego przycisku; oraz progress bez atrybutu value. Dla grupy radiowej dopasowanie dotyczy wszystkich jej przycisków, nie tylko jednego. progress z value="0" ma już określoną wartość i nie pasuje.

Przeglądarka bez obsługi atrybutu switch może go zignorować. Wówczas pole wyboru z tym atrybutem może nadal pasować do :indeterminate, jeśli jego właściwość indeterminate ma wartość true.

Dla pola wyboru ustawiaj indeterminate przez JavaScript. Ta właściwość jest niezależna od checked: samo jej ustawienie nie zmienia zaznaczenia. Nie utożsamiaj więc :indeterminate z „niezaznaczony” ani z :not(:checked). CSS wybiera stan, ale go nie ustawia.

Przykład zapisuje listę dopasowań, następnie usuwa stan nieokreślony pola wyboru, zaznacza jeden przycisk radiowy i ustawia postęp na zero. Druga lista jest pusta. Przykład nie używa atrybutu switch i nie sprawdza tego wyjątku. Oczekiwany wynik dotyczy tekstu, a nie wyglądu natywnych kontrolek; zgodność przykładu z docelową przeglądarką wymaga lokalnego sprawdzenia.

Przykłady

<!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>

Wynik

box, a, b, task
(none)

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła