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

CKTIS / CSS

:user-valid — campo válido após interação do utilizador

A pseudoclasse :user-valid seleciona controlos de formulário válidos apenas quando a condição de interação do utilizador é satisfeita. Ao contrário de :valid, não indica automaticamente que um campo ainda não tocado é válido.

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

Sintaxe

input:user-valid { /* declarations */ }

:user-valid é uma pseudoclasse sem argumentos. Em HTML, corresponde aos elementos input, textarea e select sujeitos à validação de restrições, que cumprem essas restrições e cujo estado interno user validity está definido como true.

:valid descreve a validade sem essa condição adicional. Assim, um campo com um valor inicial válido pode corresponder a :valid, mas não a :user-valid. A pseudoclasse oposta, :user-invalid, indica invalidade depois de satisfeita a condição de interação; não corresponder a ela não significa que o campo corresponda a :user-valid.

Não assuma que basta focar um controlo ou atribuir-lhe .value para ativar este estado. O momento exato em que é ativado durante a edição pode depender do navegador. Uma tentativa de enviar o formulário proporciona um ponto de verificação claro, enquanto a reposição limpa o estado de interação.

O exemplo começa com o valor válido Ada. Prima Submit sem editar e, em seguida, Reset. O script impede a navegação, não a validação. O texto junto ao campo complementa a cor do contorno; o seletor apenas estiliza um estado e não valida dados no servidor.

Exemplos

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>:user-valid demo</title>
<style>
  input { border: 2px solid #666; padding: 0.4rem; }
  input:user-valid { border-color: #087a35; }
  .status::after { content: "Not user-valid"; }
  input:user-valid + .status::after { content: "User-valid"; }
</style>
<form id="demo">
  <label for="name">Name (required)</label>
  <input id="name" name="name" required value="Ada">
  <span class="status" aria-live="polite"></span>
  <button type="submit">Submit</button>
  <button type="reset">Reset</button>
</form>
<script>
  document.querySelector('#demo').addEventListener('submit', (event) => {
    event.preventDefault();
  });
</script>
</html>

Resultado

Initially: Not user-valid; gray border.
After Submit without editing: User-valid; green border.
After Reset: Not user-valid; gray border.

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