Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / CSS

:indeterminate — pseudoclasse de estado indeterminado

A pseudoclasse :indeterminate corresponde a controlos num estado indeterminado: caixas de verificação configuradas adequadamente, botões de opção de um grupo sem seleção e elementos progress sem atributo value. Não significa simplesmente «não selecionado».

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

Sintaxe

:indeterminate

:indeterminate é uma pseudoclasse de estado, não um pseudoelemento. Permite estilizar um controlo existente cujo estado é indeterminado. A forma input:indeterminate limita as correspondências aos elementos input; :indeterminate, por si só, também inclui os elementos progress correspondentes.

A norma HTML define três casos: um input do tipo checkbox cuja propriedade indeterminate é true e que não tem o atributo switch; cada botão radio cujo grupo não contenha nenhum botão selecionado; e um elemento progress sem atributo value. Num grupo de botões de opção, todos os botões correspondem, não apenas um. Um elemento progress com value="0" já tem um valor determinado e não corresponde.

Um navegador que não suporte o atributo switch pode ignorá-lo. Nesse caso, uma caixa de verificação com esse atributo pode continuar a corresponder a :indeterminate se a sua propriedade indeterminate for true.

Numa caixa de verificação, define indeterminate através de JavaScript. Esta propriedade é independente de checked: defini-la, por si só, não altera o estado de seleção. Por isso, não equipares :indeterminate a «não selecionado» nem a :not(:checked). CSS seleciona o estado, mas não o define.

O exemplo regista os elementos correspondentes e, em seguida, remove o estado indeterminado da caixa, seleciona um botão de opção e define o progresso como zero. A segunda lista fica vazia. O exemplo não usa o atributo switch nem testa essa exceção. O resultado esperado diz respeito ao texto, não ao aspeto dos controlos nativos; o exemplo ainda precisa de ser verificado localmente no navegador de destino.

Exemplos

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

Resultado

box, a, b, task
(none)

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes