Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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.

Izvori