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

CKTIS / HTML

aria-invalid — oznámení neplatné hodnoty

`aria-invalid` sděluje chybový stav pole, ale neprovádí validaci a nebrání odeslání formuláře.

Verze: WAI-ARIA 1.2

Syntaxe

<input aria-invalid="true" aria-describedby="error">

Hodnoty jsou false, true, grammar a spelling. Výchozí stav chybu nehlásí. Stav odvoď od skutečné kontroly, obvykle po interakci nebo pokusu o odeslání; neoznačuj zbytečně dosud nepoužitý prázdný formulář jako chybný.

Zobraz užitečné vysvětlení a spoj je s polem. Změna ARIA nenahrazuje omezení HTML ani serverovou kontrolu. Po opravě hodnoty odstraň zastaralou chybu a uprav stav.

Příklad zjistí číslice ve jméně vyžadujícím písmena a zobrazí vysvětlení. Strom přístupnosti dostane neplatný stav, ale checkValidity() vrátí pravdu, protože nebylo nastaveno nativní omezení. Jde o záměrnou ukázku hranice, ne úplnou validaci formuláře.

Příklady

<!doctype html><meta charset="utf-8">
<label for="name">Project name</label><input id="name" value="123" aria-describedby="error">
<p id="error" hidden>Use letters only.</p><output id="result"></output>
<script>
const input = document.querySelector('#name');
const invalid = !/^[A-Za-z]+$/.test(input.value);
input.setAttribute('aria-invalid', String(invalid));
document.querySelector('#error').hidden = !invalid;
document.querySelector('#result').textContent = 'marked=' + invalid + '; nativeValid=' + input.checkValidity();
</script>

Výsledek

marked=true; nativeValid=true

Test kontroluje viditelné vysvětlení a sémantickou chybu a odlišuje je od nativní platnosti pole.

Zdroje