CKTIS / HTML
oninvalid — gestire una convalida non riuscita
L’attributo oninvalid contiene codice JavaScript che gestisce l’evento invalid quando un controllo verificato non soddisfa i vincoli del modulo. Non viene eseguito automaticamente a ogni pressione di un tasto.
Versione: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintassi
oninvalid="JavaScript statements"oninvalid è l’attributo gestore dell’evento invalid. Il suo valore è codice JavaScript; all’interno del gestore, event identifica l’evento e this l’elemento. La proprietà JavaScript corrispondente, element.oninvalid, accetta una funzione.
L’evento si attiva su un controllo soggetto a convalida quando un controllo rileva la violazione di un vincolo, per esempio un valore vuoto con required. I controlli possono avvenire durante l’invio del modulo oppure tramite checkValidity() o reportValidity(). La sola digitazione non attiva questo evento.
invalid non propaga: oninvalid sul modulo non intercetta gli eventi dei suoi controlli. Per una gestione condivisa, usa addEventListener('invalid', handler, true). L’evento è annullabile: event.preventDefault() sopprime la segnalazione predefinita del problema durante la convalida interattiva, ma non corregge il valore né consente di inviare un modulo non valido. Con checkValidity(), l’annullamento non modifica il risultato false.
Nell’esempio, il primo checkValidity() richiama il gestore e restituisce false. Dopo aver assegnato OK, il secondo controllo restituisce true senza un altro evento.
Esempi
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>oninvalid example</title>
<label>Required value <input id="field" required oninvalid="document.getElementById('result').textContent += event.type + '\n'"></label>
<pre id="result"></pre>
<script>
const field = document.getElementById('field');
const result = document.getElementById('result');
const first = field.checkValidity();
result.textContent += String(first) + '\n';
field.value = 'OK';
result.textContent += String(field.checkValidity());
</script>
</html>Risultato
invalid false true
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.