Addaw, joan hasierara Egin dohaintza

Teknika ARIA WCAG 2.2

ARIA2Derrigorrezko eremuak aria-required atributuarekin markatzea

Izen ofiziala W3Cn: Derrigorrezko eremu bat identifikatzea aria-required propietatearekin

Versión en castellano · Versió en català

Laburbilduz

Formulario batek derrigorrezko eremu bat izartxo batekin, kolore batekin edo «derrigorrezkoa» hitzarekin adierazten duenean, aria-required="true" atributuak datu hori pantaila-irakurgailuari helarazten dio. Horrela, marka ikusten ez duenak ere badaki. Ohar ikusgaiak bertan jarraitu behar du: aria-required bera bakarrik ez da nahikoa.

Zergatik da garrantzitsua

Izartxo gorria edo koloretako ertza ikusi baino ezin dira egin. Pantaila-irakurgailu batek (pantaila ozen irakurtzen duen programa) izartxoa salta dezake, edo «izartxoa» esan besterik ez.

Inork abisatzen ez badio, pertsonak aurretiko hitzorduaren formularioa osatu gabe bidaliko du, eta erroreak jasoko ditu. aria-required="true" erabiliz, irakurgailuak «derrigorrezkoa» iragartzen du eremura iristean, bete aurretik.

Nola egiten da

  1. Adierazi modu ikusgaian zein eremu diren derrigorrezkoak: izartxo bat, «derrigorrezkoa» hitza edo biak. Azaldu izartxoaren esanahia formularioaren hasieran.
  2. Gehitu aria-required="true" derrigorrezko eremu bakoitzari, eta horiei bakarrik.
  3. Neurrira egindako kontroletan, hala nola role="radiogroup" duen aukera-talde batean, jarri atributua aukerak biltzen dituen elementuan.
  4. HTML eremu arruntetan required atributuak ere balio du. Irakurgailuari abisatzeaz gain, nabigatzailearen balidazioa aktibatzen du.
  5. Eremu bat beste erantzun baten arabera derrigorrezkoa izateari uzten badio, aldatu balioa false-ra JavaScript bidez.

Nola egiaztatu

  1. Aurkitu derrigorrezko gisa erakusten diren eremu guztiak.
  2. Berrikusi kodean horietako bakoitzak aria-required="true" edo required duela, eta aukerakoek ez dutela.
  3. Nabigatzailearen tresnekin (F12, «Irisgarritasuna» panela), berretsi eremua derrigorrezko gisa ageri dela («required»).
  4. Ibili formularioan zehar NVDA edo VoiceOver erabiliz. Derrigorrezko eremu bakoitzean «derrigorrezkoa» edo «beharrezkoa» entzun behar duzu.

Adibidea

Aurretiko hitzorduaren formulario bateko derrigorrezko eremua, izartxoarekin eta aria-required atributuarekin markatua.

<p>Izartxoa (*) duten eremuak derrigorrezkoak dira.</p>
<label for="dni">NAN edo AIZ *</label>
<input type="text" id="dni" aria-required="true">
Ikusi W3Cren testu osoa (euskarazko itzulpena)

W3Cren Techniques for WCAG 2.2 dokumentuko ARIA2 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 indartzea formularioko eremu bat (aurkezpenaren bidez derrigorrezko gisa erakusten dena) ezinbestekoa dela formularioa behar bezala bidali ahal izateko, eta hori programatikoki adieraztea.

Elementua derrigorrezkoa dela modu bisualean aurkezten da normalean (testu-ikur baten edo testua ez den ikur baten bidez, sarrera derrigorrezkoa dela dioen testu baten bidez, edo kolorearen edo estiloen bidez), baina baliteke hori ezin izatea programatikoki zehaztu eremuaren izenaren zati gisa.

WAI-ARIAren aria-required propietateak adierazten du erabiltzaileak datuak sartu behar dituela bidali aurretik. aria-required propietateak true edo false balioak izan ditzake. Adibidez, erabiltzaileak helbide-eremu bat bete behar badu, aria-required true balioan ezartzen da.

Teknika hau gomendatutzat jotzen da 3.3.2 Etiketak edo argibideak irizpidea betetzeko, aria-required="true" bera bakarrik, inolako adierazle bisualik gabe, erabiltzaile gehienek ezin baitute hauteman.

Hala ere, eremuak izartxo bat edo beste testu-ikur bat lotuta duenean, aurkezpen bisualaz gain aria-required propietatea erabiltzeak aukera ematen die erabiltzaile-agenteei informazio garrantzitsu hori erabiltzaileari helarazteko, erabiltzaile-agente bakoitzari dagokion moduan. Kontsultatu ARIA in HTML WAI-ARIAren egoerak eta propietateak HTMLrekin nola eman jakiteko. WAI-ARIAren egoerak eta propietateak beste lengoaia batzuekin ere bateragarriak dira; kontsultatu lengoaia horien dokumentazioa.

Adibideak

required propietatea label elementuaren barruan jarritako izartxo batekin adierazten da

<form>
  <p>Note: * denotes a required field</p>
  <div>
    <label for="usrname">Login name *:</label>
    <input aria-required="true" autocomplete="username" id="usrname" type="text">
  </div>
  <div>
    <label for="pwd">Password *:</label>
    <input aria-required="true" autocomplete="current-password"
     id="pwd" type="password">
  </div>
  <div>
    <input type="submit" value="Login">
  </div>
</form>

required propietatea label elementuaren ondoan jarritako "required" (derrigorrezkoa) hitzarekin adierazten da

<form>
  <div>
    <label for="fname">First name:</label> <span>(required)</span>
    <input aria-required="true" autocomplete="given-name" id="fname" type="text">
  </div>
  <div>
    <label for="mname">Middle name:</label> <span>(required)</span>
    <input autocomplete="additional-name" id="mname" type="text">
  </div>
  <div>
    <label for="lname">Last name:</label> <span>(required)</span>
    <input aria-required="true" autocomplete="family-name" id="lname" type="text">
  </div>
  <div>
    <label for="email">Email address:</label> <span>(required)</span>
    <input aria-required="true" autocomplete="email" id="email" type="text">
  </div>
  <div>
    <label for="zip_post">Zip / Postal code:</label> <span>(required)</span>
    <input aria-required="true" autocomplete="postal-code" id="zip_post" type="text">
  </div>
  <div>
    <input type="submit" value="Next Step">
  </div>
</form>

Derrigorrezko eremuak eremuen inguruko ertz gorri batekin eta CSSko ::after bidez sortutako izar-ikono batekin adierazten dira

Adibide honek role=radio duten aukera-botoi pertsonalizatuak erabiltzen ditu. CSS propietateak formularioaren azpian daude.

<form>
  <label data-required="true" for="acctnum">Account Number</label>
  <input aria-required="true" id="acctnum" type="text">
  <p data-required="true" id="radio_label">
    Please send an alert when balance exceeds $3,000.
  </p>
  <ul aria-required="true" aria-labelledby="radio_label" role="radiogroup">
    <li aria-checked="false" id="rb1" role="radio" tabindex="0">Yes</li>
    <li aria-checked="false" id="rb2" role="radio" tabindex="-1">No</li>
  </ul>
</form>

Adibide honi dagokion CSS estiloen definizioa:

[aria-required=true] {
  border: red thin solid;
}
[data-required=true]::after {
  content: url('/iconStar.gif');
}

Probak

Prozedura

Aurkezpenaren bidez derrigorrezko gisa erakusten den kontrol bakoitzerako.

  1. Egiaztatu aria-required atributua badagoen:
  2. Egiaztatu aria-required atributuaren balioa bat datorren erabiltzaile-interfazeko osagaiaren derrigortasun-egoera zuzenarekin.

Espero diren emaitzak

  • 1. eta 2. 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 ARIA2 teknikan oinarritua (WCAG 2.2). Azalpena eta adibideak: ADDAW. W3Cren testuaren itzulpen ez-ofiziala © W3C, W3Cren dokumentu-lizentzia. Akatsen bat ikusi duzu? Idatzi iezaguzu.