CKTIS / HTML
role — vloga elementa z vidika dostopnosti
Atribut `role` določa semantično vlogo elementa za podporne tehnologije. Ne doda videza ali vedenja. Uporabljajte ga v skladu s pravili ARIA in HTML in dajte prednost elementom, ki že zagotavljajo ustrezno izvorno semantiko.
Različica: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaksa
role="role-name [fallback-role-name ...]"Atribut role podpornim tehnologijam sporoča vrsto elementa, na primer skupino ali gumb. Nanaša se na semantiko v drevesu dostopnosti, ne na videz. Ne nadomesti dostopnega imena: v primeru group določa vlogo, aria-label pa ime Display options.
Vrednost lahko vsebuje imena vlog, ločena z belimi znaki. Pri določanju vloge brskalnik uporabi prvo prepoznano ime neabstraktne vloge. Seznam zagotavlja nadomestne vloge, ne več hkrati veljavnih vlog. Tako izbrana vloga pa ni nujno tista, ki jo brskalnik izpostavi v drevesu dostopnosti. Pri elementu button, ki lahko prejme fokus, mora brskalnik na primer prezreti none ali presentation in namesto tega izpostaviti implicitno vlogo gumba. Abstraktnih vlog se v vsebini strani ne sme uporabljati.
Dajte prednost izvornemu elementu HTML z ustrezno semantiko. button že ima vlogo gumba, zato je njeno ponavljanje odveč. Dovoljene zamenjave so odvisne od elementa in pravil ARIA in HTML; vsaka vloga ni povsod veljavna. Upoštevajte tudi zahteve izbrane vloge glede imen, stanj in strukture.
Samo dodajanje role="button" ne zagotovi upravljanja s tipkovnico, možnosti pridobitve fokusa ali dejanj. Primer združuje dva izvorna izbirna gumba (<input type="radio">), ne da bi prepisal njuni vlogi. Ko se izbrana možnost spremeni, skript spremeni velikost pisave vzorčnega besedila. output je izpis v konzoli, ki vsebuje deklarirani vrednosti atributov role in aria-label ter vidno besedilo skupine. Ne gre za pregled drevesa dostopnosti.
Primeri
<!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
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.