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.