Addaw, joan hasierara Egin dohaintza

Teknika HTML WCAG 2.2

H91HTMLren berezko formulario-kontrolak eta estekak erabiltzea

Izen ofiziala W3Cn: HTMLko formulario-kontrolak eta estekak erabiltzea

Versión en castellano · Versió en català

Laburbilduz

Botoi, esteka, kontrol-lauki edo zerrendetarako, seguruena HTMLren berezko elementuak erabiltzea da: button, href duen a, input, select. Teklatuarekin funtzionatzen dute, ezer programatu gabe. Gainera, nabigatzaileak pantaila-irakurgailuei jakinarazten die zer diren, nola deitzen diren eta zer egoeratan dauden.

Zergatik da garrantzitsua

<div> batekin egindako botoi batek botoia dirudi, baina ez da botoia. Ez du fokua jasotzen tabuladorearekin, eta ez dio Sartu teklari erantzuten. Pantaila-irakurgailuak (pantaila ozen irakurtzen duen programa) ez du botoi gisa iragartzen.

Elementu natiboek hori guztia dakarte berez: teklatu bidezko erabilera, funtzioa, izena, egoera eta balioa. Horrela, teklatua edo pantaila-irakurgailua erabiltzen duenak oztoporik gabe erabil ditzake.

Nola egiten da

  1. Beste orri edo atal batera joateko, erabili <a>, href atributuarekin. href gabe ez da esteka bat.
  2. Ekintza bat gauzatzeko, erabili <button>.
  3. Datuak eskatzeko, erabili <input>, <select> edo <textarea>.
  4. Eman kontrol bakoitzari izen bat: botoiaren edo estekaren testua, haren irudiaren alt atributua, edo <label> bat eremuetan.
  5. Esteka batean irudi bat eta testua elkartzen badituzu, utzi zuriune bat haien artean, hitzak elkarri itsatsita irakur ez daitezen.

Nola egiaztatu

  1. Zeharkatu orria tabuladorearekin. Kontrol guztiek jaso behar dute fokua.
  2. Aktibatu bakoitza Sartu teklarekin edo zuriune-barrarekin, eta egiaztatu funtzionatzen duela.
  3. Nabigatzailearen tresnekin (F12, Irisgarritasuna fitxa), berrikusi kontrol bakoitzak funtzio eta izen zuzenak dituela.
  4. Bilatu botoi edo esteka gisa jokatzen duten <div> edo <span> elementuak, eta ordeztu elementu natiboekin.

Adibidea

Lehen botoia natiboa da eta teklatuarekin funtzionatzen du; bigarrenak saguarekin bakarrik funtzionatzen du.

<!-- Zuzena -->
<button type="button">Gehitu saskira</button>
<a href="/contacto">Harremanetarako</a>

<!-- Okerra -->
<div class="boton" onclick="anadir()">Gehitu saskira</div>
Ikusi W3Cren testu osoa (euskarazko itzulpena)

W3Cren Techniques for WCAG 2.2 dokumentuko H91 teknikaren euskarazko itzulpen ez-ofiziala da hau. Akatsak izan ditzake. Dokumentu ofizial eta arauemaile bakarra jatorrizko bertsioa da, ingelesez, W3Cren webgunean argitaratua.

Aplikagarritasuna

HTMLko formulario-kontrolak eta estekak

Deskribapena

Teknika honen helburua da HTMLren formulario-kontrol eta esteka-elementu estandarrak erabiltzea, erabiltzaile-interfazeko elementu interaktiboei teklatu bidezko erabilera eta laguntza-teknologiekiko elkarreragingarritasuna emateko.

Erabiltzaile-agenteek ematen dute HTMLko formulario-kontrolen eta esteken teklatu bidezko erabilera. Gainera, erabiltzaile-agenteak formulario-kontrolak eta estekak irisgarritasun-API batera esleitzen ditu. Laguntza-teknologiek irisgarritasun-APIa erabiltzen dute irisgarritasun-informazio egokia ateratzeko, hala nola funtzioa, izena, egoera eta balioa, eta erabiltzaileei aurkezteko. Funtzioa HTML elementuak ematen du, eta izena elementu horri lotutako testuak. Balioek eta egoerek zentzua duten elementuek ere hainbat mekanismoren bidez erakusten dituzte.

Zenbait kasutan, testua dagoeneko kontrolari lotuta dago derrigorrezko atributu baten bidez. Adibidez, bidaltze-botoiek button elementuaren testua edo irudiaren alt atributua erabiltzen dute izen gisa. Formulario-kontrolen kasuan, label elementuak, aria-label edo aria-labelledby propietateak, edo title atributua erabiltzen dira.

Adibideak

Estekak

Erabiltzaile-agenteek estekaraino mugitzeko eta haiek hautatzeko mekanismoak eskaintzen dituzte. Ondorengo adibide bakoitzean, funtzioa «link» (esteka) da, a elementuak href atributua duelako. href gabeko a elementu bat ez da esteka bat. Estekaren balioa URIa da, href atributuan dagoena.

Esteken A adibidea

A adibidean, izena estekaren barruan dagoen testua da, kasu honetan «Example Site» (adibide-webgunea).

<a href="https://example.com">Example Site</a>

Esteken B adibidea

B adibidean, esteka baten barruko irudi batena, irudiaren alt atributuak ematen du izena.

<a href="https://example.com"><img alt="Example" src="example-logo.gif"></a>

Esteken C adibidea

C adibidean, laguntza-teknologia batzuek ez dute automatikoki zuriunerik txertatzen irudiaren alt testua estekaren testuarekin kateatzean. Testua zuriunerik gabe kateatu behar ez bada, seguruena irudiaren eta ondoko hitzaren artean zuriune bat txertatzea da, hitzak elkarri itsatsita gera ez daitezen.

<a href="https://example.com"><img alt="Example " src="example_logo.gif">Text</a>

Botoiak

HTMLn hainbat modutara sor daiteke botoi bat.

Botoien A adibidea

A adibidean, button elementuaren barruko testuak, kasu honetan «save» (gorde), ematen dio izena botoiari. Ez dago baliorik.

<button type="button">Save</button>

Botoien B adibidea

B adibideak value atributua erabiltzen du izen gisa, kasu honetan «Save» (gorde), «Submit» (bidali) edo «Reset» (berrezarri).

<input type="button" value="Save"> 
<input type="submit" value="Submit">
<input type="reset" value="Reset">

Botoien C adibidea

C adibideak alt atributua erabiltzen du izen gisa, kasu honetan «save» (gorde).

<input alt="save" src="save.gif" type="image">

Botoien D adibidea

D adibideak argitzen du nola zehazten duen erabiltzaile-agenteak izena egileak input elementuaren alt eta title atributuak aldi berean zehazten dituenean. Kasu honetan, erabiltzaile-agenteak alt atributua («Save») erabiltzen du eta title atributuari ez dio jaramonik egiten.

<input alt="save" src="save.gif" title="save the file" type="image">

Testu-eremua

Testu-eremuaren A adibidea

A adibidean, sarrera-eremuak «editable text» (testu editagarria) funtzioa du. label elementua input elementuari lotuta dago for atributuaren bidez, input elementuaren id atributuari erreferentzia egiten baitio. Izena label elementutik dator, kasu honetan «Type of fruit» (fruta mota). Haren balioa bere value atribututik dator, kasu honetan «bananas» (bananak).

<label for="text-1">Type of fruit</label>
<input id="text-1" type="text" value="bananas">

Testu-eremuaren B adibidea

B adibidean, sarrera-eremuak A adibidean duen funtzio bera du, baina balioa kate hutsa da, eta eremuak aria-label propietatetik lortzen du izena.

<input aria-label="Type of fruit" id="text-1" type="text">

Kontrol-laukia

Adibide honek checkbox funtzioa du, input elementuaren type atribututik datorrena. label elementua input elementuari lotuta dago for atributuaren bidez, input elementuaren id atributuari erreferentzia egiten baitio. Izena label elementutik dator, kasu honetan «cheese» (gazta). Haren egoera checked edo unchecked izan daiteke, eta checked atribututik dator. Egoera alda daiteke erabiltzaileak kontrolarekin elkarreragitean.

<label for="cb-1">Cheese</label> 
<input checked id="cb-1" type="checkbox">

Aukera-botoiak

Adibide honek «radio button» (aukera-botoia) funtzioa du, input elementuaren type atribututik datorrena. Haren izena label elementutik dator. Haren egoera checked edo unchecked izan daiteke, eta checked atribututik dator. Egoera alda daiteke erabiltzaileak kontrolarekin elkarreragitean.

<input checked id="r1" name="color" type="radio"><label for="r1">Red</label>
<input id="r2" name="color" type="radio"><label for="r2">Blue</label>
<input id="r3" name="color" type="radio"><label for="r3">Green</label>

Aukera-botoien fieldset elementua

Aukera-botoien fieldset elementuak «grouping» (taldekatzea) funtzioa du. Izena legend elementutik dator.

<fieldset>
  <legend>Choose a Color:</legend>
  <div>
    <input id="red" name="color" type="radio" value="red">
    <label for="red">Red</label>
  </div>
  <div>
    <input id="blue" name="color" type="radio" value="blue">
    <label for="blue">Blue</label>
  </div>
  <div>
    <input id="green" name="color" type="radio" value="green">
    <label for="green">Green</label> 
</fieldset>

select elementua

select elementuaren A adibidea

A adibideak «list box» (zerrenda-koadroa) funtzioa du, select elementutik datorrena. Haren izena «Numbers» (zenbakiak) da, eta label elementutik dator. Select elementuari izena ematea ahaztea ohiko akatsa da. Balioa selected atributua duen option elementua da. Kasu honetan, balio lehenetsia «Two» (bi) da.

<label for="s1">Numbers</label>
<select id="s1">
  <option>One</option>
  <option selected>Two</option>
  <option>Three</option>
</select>

select elementuaren B adibidea

B adibideak aurrekoaren izen, funtzio eta balio berak ditu, baina izena select elementuko aria-label propietatearekin ezartzen du. Teknika hau erabil daiteke etiketa ikusgai bat erakutsi ezin denean.

<select aria-label="Numbers" id="s1">
  <option>One</option>
  <option selected>Two</option>
  <option>Three</option>
</select>

Textarea

Textarea elementuaren A adibidea

A adibideak «editable text» (testu editagarria) funtzioa du, textarea elementutik datorrena. Izena «Type your speech here» (idatzi hemen zure hitzaldia) da, eta label elementutik dator. Balioa textarea elementuaren barruan dagoen edukia da, kasu honetan «Four score and seven years ago».

<label for="ta-1">Type your speech here</label>
<textarea id="ta-1">Four score and seven years ago</textarea>

Textarea elementuaren B adibidea

B adibideak funtzio eta balio berak ditu. Izena title atributuaren bidez ezartzen da.

<textarea title="Type your speech here">Four score and seven years ago</textarea>

Probak

Prozedura

  1. Ikuskatu HTML iturburu-kodea.
  2. Esteka eta formulario-elementu bakoitzerako, egiaztatu izena, balioa eta egoera zehazten direla.

Espero diren emaitzak

  • 2. egiaztapena egiazkoa da.

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