Addaw, joan hasierara Egin dohaintza

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

Versión en castellano · Versió en català

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

  1. Jarri hasierako HTMLan role="alert" duen edukiontzi huts bat; aria-live="assertive" erabiltzearen baliokidea da.
  2. Gehitu aria-atomic="true", mezu osoa irakur dadin. iPhone eta iPadeko VoiceOverrek behar du, bigarren bidalketatik aurrera abisua emateko.
  3. Errorea detektatzean, idatzi testua edukiontzi horren barruan JavaScript bidez.
  4. Bidalketa berri bakoitzean, hustu edukiontzia mezu berria idatzi aurretik.
  5. Gorde role="alert" erroreetarako eta abisu larrietarako. Arrakasta-mezuetarako, erabili role="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.

Adibide okerraren pantaila-argazkia: Eskualde bizirik gabeko paragrafo batean idatzitako errorea
Horrela ikusten da adibide okerra.

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

Pantaila-irakurgailua (NVDA edo VoiceOver)

  1. Eremua hutsik dagoela, jarri fokua «Harpidetu» botoian eta sakatu Sartu.
  2. Egiaztatu errore-mezua iragartzen dela fokua mugitu gabe.
  3. Sakatu Sartu berriro eta egiaztatu mezua berriro iragartzen dela.

Hau iragarri beharko luke: «Errorea: idatzi baliozko helbide elektroniko bat; adibidez, izena@domeinua.eus.»

Nabigatzailearen tresnak

  1. Ireki garapen-tresnak (F12) Elementuak fitxan.
  2. Egiaztatu role="alert" (edo aria-live="assertive") duen edukiontzi hutsa lehendik badagoela errorea eragin aurretik.
  3. Irisgarritasuna fitxan, egiaztatu edukiontziak «alert» funtzioa duela.
  4. Egiaztatu mezua edukiontzi horren barruan idazten dela, ez elementu berri batean.

Teklatua

  1. Bidali formularioa teklatua soilik erabilita. Mezua botoiaren ondoan ikusi behar da, eta fokuak ez du beste leku batera jauzi egin behar.

Balidazio automatikoa

  1. axe DevTools-ek, WAVEk eta Lighthouse-k ez dute egiaztatzen geroago agertzen den mezu bat iragartzen den. Ez dute detektatzen eskualde bizirik ez dagoela.
  2. Gaizki idatzitako edo baliozkoak ez diren balioak dituzten ARIA atributuak baino ez dituzte adierazten (axe-ren aria-valid-attr eta aria-valid-attr-value arauak). Iragarpena pantaila-irakurgailu batekin egiaztatu behar da.

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

  1. Zehaztu orria kargatzean DOMean (Document Object Model) role=alert edo aria-live=assertive atributua duen errore-edukiontzi huts bat dagoela.
  2. Eragin eskualde biziaren edukia agerrarazten edo eguneratzen duen errorea.
  3. Zehaztu errore-mezua lehendik zegoen errore-edukiontzian txertatu dela.

Espero diren emaitzak

  • 1. eta 3. egiaztapenak egiazkoak dira.

Baliabideak

Nola egiaztatzen dugun ADDAWn

ADDAWren auditoria bakoitzean teknika hau orriz orri berrikusten dugu, eta akatsak pantaila-argazkiekin eta zuzentzeko moduarekin ematen dizkizugu.

Eskatu auditoria bat

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.