Addaw, joan hasierara Egin dohaintza

Teknika ARIA WCAG 2.2

ARIA20Orriko eremu garrantzitsu bat role="region" bidez markatzea

Izen ofiziala W3Cn: region funtzioa (rola) erabiltzea orriko eskualde bat identifikatzeko

Versión en castellano · Versió en català

Laburbilduz

Orriko zati garrantzitsu bat eskualde estandar batean ere sartzen ez bada (goiburua, menua, eduki nagusia, orri-oina…), role="region" bidez marka daiteke, eta izen bat eman. Horrela, pantaila-irakurgailuaren eskualde-zerrendan agertzen da, eta zuzenean irits daiteke hara. Neurriz erabiltzea komeni da.

Zergatik da garrantzitsua

Pantaila-irakurgailua erabiltzen duten pertsonek eskualde batetik bestera jauzi egiten dute azkar mugitzeko. Eremu erabilgarri bat (eguraldia, inkesta bat edo kontu baten saldoa, adibidez) markatuta ez badago, dena irakurriz bilatu behar dute.

Izena ezinbestekoa da: izenik gabeko eskualde batek ez du esaten zer duen. Eta eskualde gehiegik orria iragarpenez betetzen dute, eta zeharkatzeko motelagoa bihurtzen dute.

Nola egiten da

  1. Lehenik, egiaztatu eskualde estandar batek balio duen: <header>, <nav>, <main>, <aside>, <footer>, <form> edo role="search" (ARIA11 teknika).
  2. Bat ere egokitzen ez bada, markatu eremua role="region" bidez. HTMLn, izena duen <section> batek badu funtzio hori.
  3. Eman izen bat aria-labelledby bidez, haren izenburu ikusgarria adierazita. Izenbururik ez badu, erabili aria-label.
  4. Gorde eskualdeak benetan sarbide zuzena merezi duen edukirako.

Nola egiaztatu

  1. Bilatu kodean role="region" duten elementuak eta izena duten <section> elementuak.
  2. Egiaztatu haien edukia nahikoa garrantzitsua dela eskualde propioa izateko.
  3. Egiaztatu ez dela eskualde estandar batean sartzen.
  4. Egiaztatu izena duela, aria-labelledby edo aria-label bidez.
  5. Ireki pantaila-irakurgailuaren eskualde-zerrenda (NVDAn, Insert + F7; VoiceOverren, rotorra). Eremuak bere izenarekin agertu behar du.

Adibidea

Udal baten azaleko asteko inkesta, izena duen eskualde gisa markatuta.

<div role="region" aria-labelledby="tit-encuesta">
  <h2 id="tit-encuesta">Asteko inkesta</h2>
  <p>Zein udal-zerbitzu erabiltzen duzu gehien?</p>
  <a href="/encuesta">Erantzun inkestari</a>
</div>
Ikusi W3Cren testu osoa (euskarazko itzulpena)

W3Cren Techniques for WCAG 2.2 dokumentuko ARIA20 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 onartzen duten teknologiak.

Deskribapena

Teknika honek erakusten du nola esleitu region funtzio (rol) generikoa orriko atal bati, erabiltzaile-agenteek eta laguntza-teknologiek software bidez identifika dezaten. region funtzioak eduki garrantzitsua duen orriko segmentu bat mugatzen du, errazago aurkitu eta nabigatu ahal izateko. Eskualde generikoa erabili behar da atala ezin denean dokumentuko eskualde-funtzio (landmark) estandar batekin markatu (ikus ARIA11).

Garrantzitsua da eskualdeei izena ematea, taldekatze-elementu generikoak direlako eta erabiltzaileek nolabait jakin behar dutelako zein eskualdetan dauden. Eskualdeei aria-labelledby, aria-label edo beste teknika baten bidez eman dakieke izena. Hori eginez gero, hobeto azaltzen dira orriko edukia eta informazio-erlazioak. region funtzioa zuhurtziaz erabili behar da; izan ere, gehiegi erabiltzen bada, orria gehiegi berritsua izan daiteke pantaila-irakurgailuak erabiltzen dituztenentzat.

Adibideak

Eskualdea albiste-webgune batean

Albiste-webgune baten hasierako orrian astero aldatzen den inkesta bat duen atal bat role="region" bidez markatzen da. Formularioaren gainean dagoen h3-a eskualdearen izen gisa erreferentziatzen da aria-labelledby bidez.

<div role="region" aria-labelledby="pollhead">
  <h3 id="pollhead">This week's Poll</h3>
  <form>
    <fieldset>
      <legend>Do you believe the tax code needs to be overhauled?</legend>
      <input type="radio" id="r1" name="poll">
      <label for="r1">No, it's fine the way it is</label>
      <input type="radio" id="r2" name="poll">
      <label for="r2">Yes, the wealthy need to pay more</label>
      <input type="radio" id="r3" name="poll">
      <label for="r3">Yes, we need to close corporate loopholes</label>
      <input type="radio" id="r4" name="poll">
      <label for="r4">Changes should be made across the board</label>
    </fieldset>
  </form>
  <a href="results.php">See Poll Results</a>
</div>

Banku baten webgunean eskualde bat identifikatzea

Banku baten webgunean saioa hasi ondoren, erabiltzaileak estekak zabal ditzake bere epe finkoko gordailuen xehetasunak ikusteko. Xehetasunak region funtzioarekin markatutako span baten barruan daude. Eskualdearen izenburuak role=heading du, eta eskualdeari izena ematen dion aria-labelledby-n sartzen da.

<ol>
  <li>
    <button aria-controls="block1" aria-expanded="false" id="l1" title="show details"
      type="button">John Henry's Account <img alt="" src="images/panel_expand.gif">
    </button>
    <div id="block1" class="nowHidden" tabindex="-1" aria-labelledby="l1 cd1"
      role="region">
      <span id="cd1" role="heading" aria-level="3">Certificate Of Deposit</span>
      <table>
        <tr>
          <th scope="row">Account:</th>
          <td>25163522</td>
         </tr>
         <tr>
          <th scope="row">Start date:</th>
          <td>February 1, 2014</td>
         </tr>
         <tr>
          <th scope="row">Maturity date:</th>
          <td>February 1, 2016</td>
         </tr>
         <tr>
          <th scope="row">Deposit Amount:</th>
          <td>$ 3,000.00</td>
         </tr>
         <tr>
          <th scope="row">Maturity Amount:</th>
          <td>$ 3,072.43</td>
        </tr>
      </table>
    </div>
  </li>
</ol>

Portlet bat eskualde generiko batekin identifikatzea

Adibide honek erakusten du nola gehi dakiokeen region eskualde (landmark) generiko bat eguraldiaren portlet bati. Orrian ez dago etiketa gisa erreferentzia daitekeen testurik; beraz, aria-label bidez etiketatzen da.

<div role="region" aria-label="weather portlet"> 
  ...
</div>

Probak

Prozedura

role="region" bidez markatutako atal bakoitzerako:

  1. Aztertu edukia eta ziurtatu nahikoa garrantzitsua dela eskualde (landmark) independente bat izateko
  2. Ziurtatu eskualde-funtzio (landmark) estandarretako bat ere ez dela egokia eduki horretarako
  3. Egiaztatu eskualdeak software bidez zehaztu daitekeen izen bat duela

Espero diren emaitzak

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