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.