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

CKTIS / CSS

:in-range — um valor dentro dos limites permitidos

A pseudoclasse :in-range seleciona controlos com limites de intervalo que não ultrapassam nem o limite inferior nem o superior. No entanto, isso não significa que o campo cumpra todos os requisitos de validade.

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

Sintaxe

input:in-range { /* declarations */ }

:in-range é uma pseudoclasse sem argumentos. Em HTML, corresponde a elementos que podem ser sujeitos à validação de restrições, têm limites de intervalo e não apresentam um valor demasiado baixo nem demasiado alto. A correspondência muda consoante o valor do controlo.

Um exemplo típico é um input com type="number" e min ou max. Um intervalo normal de min="1" a max="10" inclui tanto 1 como 10. :out-of-range indica a violação de um limite. Um elemento sem limites de intervalo não corresponde a nenhuma destas pseudoclasses; por isso, :not(:out-of-range) não substitui :in-range.

Não confundas :in-range com :valid: não ultrapassar os limites não significa que as outras restrições sejam cumpridas. Um campo numérico obrigatório vazio pode corresponder tanto a :in-range como a :invalid. Do mesmo modo, um valor pode estar dentro dos limites e, ainda assim, violar step.

O exemplo mostra o estado inicial para o valor 5. A borda indica o estado do intervalo, enquanto o texto apresenta o resultado da correspondência sem depender apenas da cor.

Exemplos

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>:in-range</title>
<style>
  input:in-range { border: 3px solid green; }
  input:out-of-range { border: 3px dashed crimson; }
</style>
<label>Value (1–10): <input id="value" type="number" min="1" max="10" value="5"></label>
<pre id="result"></pre>
<script>
  const input = document.querySelector('#value');
  const result = document.querySelector('#result');
  function update() {
    result.textContent = ':in-range = ' + input.matches(':in-range');
  }
  input.addEventListener('input', update);
  update();
</script>
</html>

Resultado

:in-range = true

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