Teknika ARIA WCAG 2.2
ARIA19Formulario baten erroreak iragartzea role="alert" edo aria-live bidez
Izen ofiziala W3Cn: ARIAren alert funtzioa (rola) edo eskualde biziak erabiltzea erroreak identifikatzeko
Laburbilduz
Formulario batek errore bat orria berriro kargatu gabe erakusten duenean, pantaila-irakurgailua ez da berez ohartzen. Mezua eskualde bizi batean idazten bada (role="alert" edo aria-live duen eremu batean), berehala irakurtzen da ozenki. Eremu horrek hasieratik egon behar du orrian.
Zergatik da garrantzitsua
Pertsona itsu batek «Bidali» sakatzen du, eta fokua botoian geratzen da. Errore-mezua pantailan agertzen da, baina berak ez du entzuten. Dena ondo joan dela uste du.
Eskualde bizi batek pantaila-irakurgailuak mezua irakurtzea eragiten du, fokua mugitu gabe. Horrela, pertsonak badaki errore bat dagoela, eta zuzendu egin dezake.
Nola egiten da
- Jarri hasierako HTMLan
role="alert"duen edukiontzi huts bat;aria-live="assertive"erabiltzearen baliokidea da. - Gehitu
aria-atomic="true", mezu osoa irakur dadin. iPhone eta iPadeko VoiceOverrek behar du, bigarren bidalketatik aurrera abisua emateko. - Errorea detektatzean, idatzi testua edukiontzi horren barruan JavaScript bidez.
- Bidalketa berri bakoitzean, hustu edukiontzia mezu berria idatzi aurretik.
- Gorde
role="alert"erroreetarako eta abisu larrietarako. Arrakasta-mezuetarako, erabilirole="status".
Adibide praktikoa
Lineako denda baten buletinera harpidetzeko formularioa. Helbide elektronikoa JavaScript bidez balidatzen du, orria berriro kargatu gabe. Errore-mezua botoiaren ondoan agertzen da, baina fokua ez da harantz mugitzen.
Horrela ez: Eskualde bizirik gabeko paragrafo batean idatzitako errorea
Mezua gorriz ikusten da, baina <p> arrunt batean idazten da. Pantaila-irakurgailuak ez du ezer iragartzen. Pertsona botoian jarraitzen du, bidalketak huts egin duela jakin gabe. Hori ohartzeko, aktibatu NVDA edo VoiceOver eta bidali formularioa hutsik.

Erakustaldiak nahita dauka azaltzen den irisgarritasun-akatsa.
Ikusi adibide okerraren kodea
<form id="boletin" action="#" novalidate>
<label for="correo">Helbide elektronikoa</label>
<input type="email" id="correo" autocomplete="email">
<button>Harpidetu</button>
<p id="error" class="error"></p>
</form>
<style>.error { color: #b00020; font-weight: bold; }</style>
<script>
document.getElementById('boletin').addEventListener('submit', function (e) {
e.preventDefault();
var campo = document.getElementById('correo');
var valido = campo.value && campo.validity.valid;
document.getElementById('error').textContent = valido ? '' :
'Errorea: idatzi baliozko helbide elektroniko bat; adibidez, izena@domeinua.eus.';
});
</script>Horrela bai: Kargatzen denetik role="alert" duen edukiontzia
Paragrafo berak role="alert" eta aria-atomic="true" ditu orria kargatzen denetik. Horrela, bertan idazten den testua berehala iragartzen da. Bidalketa bakoitzean edukiontzia hustu eta mezua berriro idazten da. Horrela, errorea errepikatzen bada ere iragartzen da.
Probatu hemen:
Ikusi adibide zuzenaren kodea
<form id="boletin" action="#" novalidate>
<label for="correo">Helbide elektronikoa</label>
<input type="email" id="correo" autocomplete="email">
<button>Harpidetu</button>
<p id="error" class="error" role="alert" aria-atomic="true"></p>
</form>
<style>.error { color: #b00020; font-weight: bold; }</style>
<script>
document.getElementById('boletin').addEventListener('submit', function (e) {
e.preventDefault();
var campo = document.getElementById('correo'), caja = document.getElementById('error');
var valido = campo.value && campo.validity.valid;
caja.textContent = '';
if (!valido) setTimeout(function () {
caja.textContent = 'Errorea: idatzi baliozko helbide elektroniko bat; adibidez, izena@domeinua.eus.';
}, 100);
});
</script>Nola egiaztatu
Auditorietako ohiko akatsak
- role="alert" duen edukiontzia errorea gertatzen den unean bertan sortzea. Pantaila-irakurgailu askok ez dute iragartzen.
- Lehendik zegoen mezu bera idaztea, edukiontzia aurretik hustu gabe. Bigarren errorea ez da iragartzen.
- role="alert" formulario osoan edo edukiontzi handi batean jartzea. Zerbait aldatzen den bakoitzean osorik irakurtzen da.
- role="alert" informazio-mezuetan edo arrakasta-mezuetan erabiltzea. Ez dira larriak, eta role="status"-en joan behar dute.
Ikusi W3Cren testu osoa (euskarazko itzulpena)
W3Cren Techniques for WCAG 2.2 dokumentuko ARIA19 teknikaren euskarazko itzulpen ez-ofiziala da hau. Akatsak izan ditzake. Dokumentu ofizial eta arauemaile bakarra jatorrizko bertsioa da, ingelesez, W3Cren webgunean argitaratua.
Aplikagarritasuna
Accessible Rich Internet Applications (WAI-ARIA) onartzen duten teknologiak.
Deskribapena
Teknika honen helburua da laguntza-teknologiei jakinaraztea datuak sartzean errore bat gertatu dela. aria-live atributuari esker, laguntza-teknologia batek (pantaila-irakurgailu batek, adibidez) jakinarazpen bat jaso dezake errore-mezuak eskualde bizi (live region) baten edukiontzian txertatzen direnean. aria-live eskualdearen edukia automatikoki irakurtzen du laguntza-teknologiak, testua erakusten den lekuan fokua jarri beharrik gabe.
Badira, halaber, kasu berezietarako eskualde bizien hainbat funtzio (rol), eskualde biziaren propietateak zuzenean aplikatu beharrean erabil daitezkeenak.
Adibideak
Errore-mezuak DOMean lehendik dagoen role=alert duen edukiontzi batean txertatzea
Hurrengo adibideak role=alert erabiltzen du; aria-live=assertive erabiltzearen baliokidea da.
Adibidean, errore-mezuentzako edukiontzi-elementu huts bat dago, aria-atomic=true eta aria-live propietate bat edo alert funtzio bat dituena, orria kargatzean DOMean dagoena. Errore-edukiontziak DOMean egon behar du orria kargatzean, pantaila-irakurgailu gehienek errore-mezua irakur dezaten. aria-atomic=true beharrezkoa da iOSeko VoiceOverrek errore-mezuak irakur ditzan baliozkoa ez den bidalketa bat baino gehiago egin ondoren.
JavaScript erabiltzen da formularioa bidaltzean sarrera-eremuak hutsik dauden egiaztatzeko eta, hala badaude, errore-mezuak eskualde biziaren edukiontzietan txertatzeko. Bidalketa berri bat egiten saiatzen den bakoitzean, aurreko errore-mezuak edukiontzitik ezabatzen dira eta berriak txertatzen dira.
// Get the form element
const form = document.getElementById('signup');
// Listen for when the form is submitted
form.addEventListener('submit', function(event) {
// Stop the form from actually submitting (so we can check it first)
event.preventDefault();
// Get references to the input fields
const firstNameInput = document.getElementById('first');
const lastNameInput = document.getElementById('last');
const emailInput = document.getElementById('email');
// Get the element where we'll show error messages
const errorsContainer = document.getElementById('errors');
// Create an empty array to collect error messages
const errorMessages = [];
// Check if first name is empty
if (firstNameInput.value === '') {
errorMessages.push('<li>Please enter your first name.</li>');
}
// Check if last name is empty
if (lastNameInput.value === '') {
errorMessages.push('<li>Please enter your last name.</li>');
}
// Check if email is empty
if (emailInput.value === '') {
errorMessages.push('<li>Please enter your email address.</li>');
}
// Clear the errors container first
// (This helps screen readers notice when new content appears)
errorsContainer.innerHTML = '';
// Wait 500 milliseconds, then show the errors
setTimeout(function() {
// If there are any errors, wrap them in a list and display them
if (errorMessages.length > 0) {
errorsContainer.innerHTML = '<ul>' + errorMessages.join('') + '</ul>';
}
}, 500);
});
<form name="signup" id="signup">
<p id="errors" role="alert" aria-atomic="true"></p>
<div>
<label for="first">First Name (required)</label>
<input autocomplete="given-name" type="text" name="first" id="first">
</div>
<div>
<label for="last">Last Name (required)</label>
<input autocomplete="family-name" type="text" name="last" id="last">
</div>
<div>
<label for="email">Email (required)</label>
<input autocomplete="email" type="text" name="email" id="email">
</div>
<div>
<input type="submit" name="button" id="button" value="Submit">
</div>
</form>
Adibide funtzionala: role=alert erabiltzea erroreak identifikatzeko.
Probak
Prozedura
- Zehaztu orria kargatzean DOMean (Document Object Model)
role=alertedoaria-live=assertiveatributua duen errore-edukiontzi huts bat dagoela. - Eragin eskualde biziaren edukia agerrarazten edo eguneratzen duen errorea.
- Zehaztu errore-mezua lehendik zegoen errore-edukiontzian txertatu dela.
Espero diren emaitzak
- 1. eta 3. egiaztapenak egiazkoak dira.
Baliabideak
- WAI-ARIA Authoring Practices Guide (WAI-ARIAren egile-praktiken gida)
- WAI-ARIA, Supported States and Properties, aria-describedby (onartutako egoerak eta propietateak: aria-describedby)
- WAI-ARIA, The Roles model, alert (funtzioen eredua: alert)
Nola egiaztatzen dugun ADDAWn
ADDAWren auditoria bakoitzean teknika hau orriz orri berrikusten dugu, eta akatsak pantaila-argazkiekin eta zuzentzeko moduarekin ematen dizkizugu.
W3Cren ARIA19 teknikan oinarritua (WCAG 2.2). Azalpena eta adibideak: ADDAW. W3Cren testuaren itzulpen ez-ofiziala © W3C, W3Cren dokumentu-lizentzia. Akatsen bat ikusi duzu? Idatzi iezaguzu.