CKTIS / HTML
role — uloga elementa za pristupačnost
Atribut `role` određuje semantičku ulogu elementa za pomoćne tehnologije. Ne dodaje izgled ni ponašanje. Upotrebljavajte ga u skladu s pravilima ARIA in HTML i prednost dajte elementima koji već pružaju odgovarajuću izvornu semantiku.
Verzija: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaksa
role="role-name [fallback-role-name ...]"Atribut role pomoćnim tehnologijama prenosi vrstu elementa, primjerice grupu ili gumb. Odnosi se na semantiku u stablu pristupačnosti, a ne na izgled. Ne zamjenjuje pristupačan naziv: u primjeru group određuje ulogu, a aria-label daje naziv Display options.
Vrijednost može sadržavati nazive uloga odvojene bjelinama. Pri određivanju uloge preglednik upotrebljava prvi prepoznati naziv neapstraktne uloge. Popis nudi zamjenske uloge, a ne više uloga koje vrijede istodobno. Tako odabrana uloga nije nužno ona koju preglednik izlaže u stablu pristupačnosti. Primjerice, za element button koji može primiti fokus preglednik mora zanemariti none ili presentation i umjesto toga izložiti implicitnu ulogu gumba. Apstraktne se uloge ne smiju upotrebljavati u sadržaju stranice.
Prednost dajte izvornom HTML elementu s odgovarajućom semantikom. button već ima ulogu gumba pa je njezino ponavljanje suvišno. Dopuštena nadjačavanja ovise o elementu i pravilima ARIA in HTML; nije svaka uloga svugdje valjana. Ispunite i zahtjeve odabrane uloge koji se odnose na nazive, stanja i strukturu.
Samo dodavanje role="button" ne omogućuje upravljanje tipkovnicom, primanje fokusa ni izvođenje radnji. Primjer grupira dva izvorna izborna gumba (<input type="radio">) bez nadjačavanja njihovih uloga. Kad se promijeni odabrana opcija, skripta mijenja veličinu fonta oglednog teksta. output je ispis u konzoli koji sadržava deklarirane vrijednosti atributa role i aria-label te vidljivi tekst grupe. Nije riječ o pregledu stabla pristupačnosti.
Primjeri
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Named group of display options</title>
</head>
<body>
<div id="display-options" role="group" aria-label="Display options">
<label><input type="radio" name="zoom" value="normal" checked> Normal size</label>
<label><input type="radio" name="zoom" value="large"> Large size</label>
</div>
<p id="sample">Sample text</p>
<script>
const group = document.getElementById('display-options');
const sample = document.getElementById('sample');
group.addEventListener('change', event => {
sample.style.fontSize = event.target.value === 'large' ? '1.5em' : '1em';
});
console.log('Declared role: ' + group.getAttribute('role'));
console.log('ARIA label: ' + group.getAttribute('aria-label'));
console.log('Visible group text: ' + group.innerText.trim().replace(/\s+/g, ' '));
</script>
</body>
</html>Rezultat
Declared role: group ARIA label: Display options Visible group text: Normal size Large size
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.