Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / HTML

aria-invalid — oznámenie neplatnej hodnoty

`aria-invalid` odovzdáva chybový stav poľa, ale nevykonáva validáciu ani nebráni odoslaniu formulára.

Verzia: WAI-ARIA 1.2

Syntax

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

Hodnoty sú false, true, grammar a spelling. Predvolený stav chybu neoznamuje. Stav vyber podľa skutočnej kontroly, zvyčajne po interakcii alebo pokuse o odoslanie; neoznačuj zbytočne ešte nepoužitý prázdny formulár za chybný.

Zobraz užitočné vysvetlenie a spoj ho s poľom. Zmena ARIA nenahrádza obmedzenia HTML ani kontrolu servera. Po oprave hodnoty odstráň neaktuálnu chybu a primerane zmeň stav.

Príklad zistí číslice v názve vyžadujúcom písmená a zobrazí vysvetlenie. Strom prístupnosti dostane neplatný stav, ale checkValidity() stále vracia pravdu, lebo nebolo určené natívne obmedzenie. Ide o zámernú ukážku hranice, nie úplnú validáciu formulára.

Prí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ýsledok

marked=true; nativeValid=true

Test overuje viditeľné vysvetlenie a sémantickú chybu oddelene od natívnej platnosti poľa.

Zdroje