Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / CSS

:invalid — un elemento che non soddisfa i vincoli di convalida

La pseudoclasse CSS :invalid corrisponde agli elementi che non soddisfano i vincoli di convalida dei dati. Permette di evidenziare valori non validi o campi obbligatori vuoti, anche prima che l’utente interagisca con essi.

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

Sintassi

:invalid

:invalid è una pseudoclasse, non una segnalazione di errori di sintassi del selettore. In HTML corrisponde ai controlli soggetti alla convalida dei vincoli che non li soddisfano. Il selettore input:invalid limita le corrispondenze agli elementi input.

La corrispondenza può verificarsi subito: un campo vuoto con required non richiede un precedente invio del modulo. :user-invalid considera anche lo stato di validità legato all’interazione dell’utente; non è un altro nome per :invalid. Gli elementi senza semantica di convalida non corrispondono né a :invalid né a :valid, quindi :not(:valid) non equivale a :invalid.

HTML comprende anche i contenitori: form:invalid corrisponde a un modulo a cui appartiene almeno un controllo non valido soggetto a convalida, mentre fieldset:invalid corrisponde a un gruppo che contiene un discendente di questo tipo. Ciò non significa che corrisponda qualsiasi antenato di un campo non valido.

L’esempio verifica un campo obbligatorio vuoto e il valore Ada, quindi ripristina il valore vuoto. Il testo atteso è fornito separatamente; l’esempio richiede una verifica locale. In un’interfaccia, non fare affidamento solo sul colore: fornisci un messaggio di errore comprensibile.

Esempi

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>:invalid example</title>
<style>
  input:invalid { outline: 3px solid crimson; }
</style>
<label for="name">Name (required)</label>
<input id="name" required autocomplete="off">
<pre id="result"></pre>
<script>
  const input = document.getElementById('name');
  const results = [];
  input.value = '';
  results.push(`empty: ${input.matches(':invalid')}`);
  input.value = 'Ada';
  results.push(`filled: ${input.matches(':invalid')}`);
  input.value = '';
  document.getElementById('result').textContent = results.join('\n');
</script>
</html>

Risultato

empty: true
filled: false

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti