Teknika ARIA WCAG 2.2
ARIA21Erroreak dituzten eremuak aria-invalid bidez markatzea
Izen ofiziala W3Cn: aria-invalid erabiltzea errorea duen eremu bat adierazteko
Laburbilduz
Formulario-eremu batek balidazioa gainditzen ez duenean, aria-invalid="true" gehitzen zaio. Orduan, pantaila-irakurgailuak iragartzen du datua ez dela baliozkoa. Onena da errore-mezua ere aria-describedby bidez lotzea, zerk huts egiten duen eta nola konpondu entzun dadin.
Zergatik da garrantzitsua
Webgune askok ertz gorri batekin baino ez dituzte markatzen erroreak. Ondo ikusten ez duenak edo koloreak bereizten ez dituenak ez daki zein eremuk huts egiten duen.
aria-invalid="true" erabilita, pantaila-irakurgailuak «baliogabea» esaten du eremura iristean. Gainera, mezua lotuta badago, pertsonak hau entzungo du, adibidez: «Helbide elektronikoa, baliogabea, a bildua falta da».
Nola egiten da
- Ez jarri
aria-invalid="true"orria kargatzean. Gehitu soilik eremuak balidazioa gainditu ez duenean. - Kendu, edo aldatu
"false"baliora, datua zuzena den bezain laster. - Idatzi eremuaren ondoan zerk huts egiten duen esaten duen errore-mezu ikusgarri bat.
- Lotu mezua eremuarekin: eman
idbat eta gehitu eremuariaria-describedby,idhorrekin. - Ez fidatu koloreaz soilik. Sartu testua edo testu alternatiboa duen ikono bat.
Nola egiaztatu
- Kargatu orria eta egiaztatu eremu batek ere ez duela oraindik
aria-invalid="true". - Bidali formularioa datu hutsekin edo gaizki idatzitako datuekin. Huts egiten duten eremuek
aria-invalid="true"izatera igaro behar dute. - Zuzendu datu bat eta egiaztatu atributua desagertzen dela edo
"false"baliora itzultzen dela. - Pantaila-irakurgailu batekin, joan errorea duen eremu batera. «Baliogabea» eta errorearen testua iragarri behar ditu.
Adibidea
Helbide elektronikoaren eremua, balidazioak huts egin ondoren, errore-mezua lotuta duela.
<label for="correo">Helbide elektronikoa</label>
<input type="email" id="correo"
aria-invalid="true" aria-describedby="error-correo">
<p id="error-correo">
Errorea: a bildua (@) falta da. Adibidez: izena@domeinua.eus
</p>
Ikusi W3Cren testu osoa (euskarazko itzulpena)
W3Cren Techniques for WCAG 2.2 dokumentuko ARIA21 teknikaren euskarazko itzulpen ez-ofiziala da hau. Akatsak izan ditzake. Dokumentu ofizial eta arauemaile bakarra jatorrizko bertsioa da, ingelesez, W3Cren webgunean argitaratua.
Aplikagarritasuna
HTML, Accessible Rich Internet Applications-ekin.
Deskribapena
Teknika honek erakusten du nola erabil daitekeen aria-invalid balidazioa gainditu ez duten eremuak identifikatzeko. aria-invalid atributua balidazio-eredu pertsonalizatu baten zati gisa erabil daiteke, HTMLko required atributua sarrera mota zehatzekin batera erabili beharrean (adibidez: type="email").
aria-invalid atributuari ez zaio "true" balioa eman behar sarreraren balidazioa egin aurretik. aria-invalid atributuari "false" balioa ematea formulario-kontrolean atributua ez jartzearen baliokidea da.
Adibideak
aria-invalid derrigorrezko eremuetan erabiltzea
aria-invalid atributua formularioa bidaltzean hutsik dauden derrigorrezko eremuetan erabiltzen da. Formularioaren gainean dagoen mezu batek erabiltzaileari adierazten dio bete beharreko formulario-eremuak daudela.
HTML:
<form name="signup" id="signup" method="post" action="">
<p id="errors" aria-live="assertive"></p>
<div>
<label for="first">First Name (required)</label>
<input aria-invalid="false" autocomplete="given-name" id="first" name="first" type="text">
</div>
<div>
<label for="last">Last Name (required)</label>
<input aria-invalid="false" autocomplete="family-name" id="last" name="last" type="text">
</div>
<div>
<label for="email">Email (required)</label>
<input aria-invalid="false" autocomplete="email" id="email" name="email" type="text">
</div>
<div>
<button id="button" type="submit">Sign Up</button>
</div>
</form>
CSS:
label.failed {
background:#CE0000;
color:#fff;
}
JavaScript:
Hauek dira aria-invalid="true" atributua ezartzen duten eta, ondoren, balidazio-errorearen mezua sortzen duten bi JavaScript funtzioak:
const requiredFields = ['first', 'last', 'email'];
let errorCount = 0;
requiredFields.forEach(fieldId => {
const field = document.getElementById(fieldId);
if (field.value.trim() === '') {
field.setAttribute('aria-invalid', 'true');
document.querySelector(`label[for='${fieldId}']`).classList.add('failed');
errorCount++;
}
});
if (errorCount > 0) {
errText.textContent = `Please complete all ${errorCount} required ${errorCount === 1 ? 'field' : 'fields'} and retry`;
}
Adibide funtzionala: aria-invalid derrigorrezko eremuetan erabiltzea.
Datuen formatuko erroreak identifikatzea
Adibide honetan, aria-invalid eta aria-describedby elkarrekin erabiltzen dira errore bat adierazteko identifikazio pertsonaleko zenbakiak (PINak), helbide elektronikoak edo hasiera-datak espero den formatua ez dutenean. Errore-mezua eremuari lotzen zaio aria-describedby bidez, eta aria-invalid-ek errazago egiten du erroreak dituzten eremuak software bidez aurkitzea.
Ezaugarriak
aria-invalid="true"atributu bat gehitzen dio formulario-eremu bati sartutako datuak falta badira edo espero den formatua ez badute:- PINak 4 karaktere baino gutxiago ditu;
- Helbide elektronikoak ez du eskatutako formatua betetzen;
- Abizenak gutxienez bi letra izan behar ditu;
- Polizaren hasiera-data gaurko data baino lehenagokoa da.
- Errore-mezu bat erakusten du, dagokion formulario-eremuarekin software bidez lotzen dena
aria-describedbyatributuaren bidez.
HTML:
<div class="control">
<label for="pin4">PIN * (4 digits)</label>
<input id="pin4" name="pin4" pattern="\d{4}" size="4" type="text" aria-describedby="pin4-errormsg" aria-invalid="true" class="error">
<span class="errtext" id="pin4-errormsg">Error: PIN is required</span>
</div>
CSS:
.error {
border: #CE0000 thin solid;
}
.errtext {
background: #EEEEFF url('error-icon.svg') no-repeat right 0.25em center;
color:#CE0000;
display:block;
margin-bottom: 1em;
max-width: fit-content;
padding: .25em 1.6em .25em .25em;
}
JavaScript:
JavaScript behar da aria-invalid, aria-describedby eta class atributuak gehitzeko, bai eta errorearen testua gehitzeko ere. Funtzio hau da balidazio-script osoaren zati garrantzitsua:
function addFieldError(field, message) {
const errId = field.id + '-errormsg';
const errDiv = document.createElement('div');
errDiv.className = 'errtext';
errDiv.id = errId;
errDiv.textContent = message;
field.parentNode.appendChild(errDiv);
field.setAttribute('aria-describedby', errId);
field.setAttribute('aria-invalid', 'true');
field.classList.add('error');
}
Adibide funtzionala: datuen formatuko erroreak identifikatzea.
Probak
Prozedura
Balidazio-akats bat adierazteko aria-invalid-en mende dagoen formulario-kontrol bakoitzerako:
- Egiaztatu
aria-invalid-i ez zaiola true balioa eman balidazio-akatsik ez dagoenean. - Egiaztatu
aria-invalid-i true balioa eman zaiola balidazio-akatsa dagoenean. - Egiaztatu eremuari software bidez lotutako etiketek edo argibide-testuak nahikoa informazio ematen dutela errorea ulertzeko.
Espero diren emaitzak
- 1.etik 3.era bitarteko egiaztapenak egiazkoak dira.
Baliabideak
- Supported States and Properties: WAI-ARIA (WAI-ARIAn onartutako egoerak eta propietateak)
- Using aria-invalid For Error Indication (aria-invalid erabiltzea erroreak adierazteko)
Nola egiaztatzen dugun ADDAWn
ADDAWren auditoria bakoitzean teknika hau orriz orri berrikusten dugu, eta akatsak pantaila-argazkiekin eta zuzentzeko moduarekin ematen dizkizugu.
W3Cren ARIA21 teknikan oinarritua (WCAG 2.2). Azalpena eta adibideak: ADDAW. W3Cren testuaren itzulpen ez-ofiziala © W3C, W3Cren dokumentu-lizentzia. Akatsen bat ikusi duzu? Idatzi iezaguzu.