Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / HTML

oninvalid – zpracování neúspěšné validace

Atribut oninvalid obsahuje JavaScriptový kód, který zpracuje událost invalid, když kontrolovaný prvek nesplňuje omezení formuláře. Nespouští se automaticky při každém stisknutí klávesy.

Verze: WHATWG HTML Living Standard; index snapshot date recorded separately

Syntaxe

oninvalid="JavaScript statements"

oninvalid je atribut obsluhy události invalid. Jeho hodnotou je JavaScriptový kód; uvnitř obslužné funkce označuje event událost a this prvek. Odpovídající JavaScriptová vlastnost element.oninvalid přijímá funkci.

Událost se vyvolá na prvku, který podléhá validaci, když kontrola zjistí porušení omezení, například prázdnou hodnotu při použití required. Kontroly mohou probíhat při odeslání formuláře nebo prostřednictvím checkValidity() či reportValidity(). Samotné psaní tuto událost nevyvolá.

invalid se nešíří směrem vzhůru: oninvalid na formuláři nezachytí události jeho ovládacích prvků. Pro společné zpracování použijte addEventListener('invalid', handler, true). Událost lze zrušit: event.preventDefault() potlačí výchozí oznámení problému během interaktivní validace, ale neopraví hodnotu ani neumožní odeslat neplatný formulář. U checkValidity() zrušení nemění výsledek false.

V příkladu první volání checkValidity() vyvolá obslužnou funkci a vrátí false. Po přiřazení hodnoty OK vrátí druhá kontrola true bez další události.

Příklady

<!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>

Výsledek

invalid
false
true

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje