Addaw, joan hasierara Egin dohaintza

Teknika HTML WCAG 2.2

H64iframe bakoitzaren edukia deskribatzen duen title bat ematea

Izen ofiziala W3Cn: iframe elementuaren title atributua erabiltzea

Versión en castellano · Versió en català

Laburbilduz

iframe batek (marko batek) beste webgune bateko edukia sartzen du orrian, hala nola mapa bat, bideo bat edo erreserba-formulario bat. Haren title atributuak zer duen esan behar du; adibidez, «Turismo-bulegoaren mapa». Horrela, pantaila-irakurgailuak iragarri egiten du, eta erabiltzaileak erabakitzen du sartu ala aurrera jarraitu.

Zergatik da garrantzitsua

Pantaila-irakurgailuek markoak iragartzen dituzte haietara iristean, eta batetik bestera jauzi egiteko aukera ematen dute. title gabe, «markoa» baino ez dute esaten, edo kanpoko zerbitzuaren testu tekniko bat, askotan ingelesez.

Pertsonak markoan sartu eta arakatu egin behar du zer den jakiteko. Izenburu on batekin, saltatu egin dezake interesatzen ez bazaio. 4.1.2 irizpideak eskatzen du osagai bakoitzak izen bat izatea. 2.4.1 irizpideak eskatzen du eduki-blokeak saltatu ahal izatea.

Nola egiten da

  1. Gehitu title <iframe> bakoitzari: title="Bideoa: nola eskatu aurretiko hitzordua".
  2. Deskribatu edukia, ez teknologia. Saihestu «iframe», «YouTube video player» edo «Kanpoko edukia».
  3. Hainbat marko badaude, eman bakoitzari izenburu desberdin bat.
  4. Berrikusi bideo- edo mapa-zerbitzuetatik kopiatzen dituzun txertatze-kodeak. Aldatu izenburua edo itzuli euskarara.
  5. Ezkutatu erabiltzailearentzako edukirik ez duten markoak, hala nola jarraipenekoak, hidden edo display: none erabiliz.

Adibide praktikoa

iframe elementuak, batez ere, beste webgune batzuetako edukia txertatzeko erabiltzen dira: mapak, bideoak, erreserba-formularioak, ordainketa-pasabideak edo txat-leihoak. Adibidean, mapa srcdoc bidez simulatzen da. Benetako webgune batean, src atributuak mapa-zerbitzura seinalatuko luke.

Horrela ez: title gabeko iframe batean txertatutako mapa

iframe elementuak ez du izenik. Markoz marko joatean, pantaila-irakurgailuak «markoa» baino ez du esaten. Gehienez ere, txertatutako dokumentuaren barneko izenburua irakurtzen du, ez baitago gure esku eta ingelesez egon ohi baita. Hori nabaritzeko, erakustaldia NVDArekin edo VoiceOverrekin korritu behar da.

Adibide okerraren pantaila-argazkia: title gabeko iframe batean txertatutako mapa
Honela ikusten da adibide okerra.

Erakustaldiak nahita dauka azaltzen den irisgarritasun-errorea.

Ikusi adibide okerraren kodea
<h2>Non gaude</h2>
<p>Turismo-bulegoa, Plaza de España, 1.</p>
<iframe width="300" height="120"
  srcdoc="<div lang='eu' style='font-family:sans-serif;background:#e6eef5;height:100px;padding:8px'>Mapa: Plaza de España, 1</div>"></iframe>

Horrela bai: Edukia deskribatzen duen title bat duen iframea

title gehitzen da, markoaren edukiaren deskribapen batekin. Irakurgailuak markora iristean iragartzen du, baita markoen zerrendan ere. Horrela, erabiltzaileak erabakitzen du sartu ala aurrera jarraitu.

Probatu hemen:

Ikusi adibide zuzenaren kodea
<h2>Non gaude</h2>
<p>Turismo-bulegoa, Plaza de España, 1.</p>
<iframe width="300" height="120"
  title="Turismo-bulegoaren kokapena erakusten duen mapa"
  srcdoc="<div lang='eu' style='font-family:sans-serif;background:#e6eef5;height:100px;padding:8px'>Mapa: Plaza de España, 1</div>"></iframe>

Nola egiaztatu

Pantaila-irakurgailua (NVDA edo VoiceOver)

  1. NVDAn, sakatu M (hurrengo markora joan) mapara iritsi arte. VoiceOverren, erabili errotorea (VO + U).
  2. Egiaztatu markoak zer duen esaten duen izen bat iragartzen dela, eta ez «markoa» bakarrik.

Hau iragarri beharko luke: «Turismo-bulegoaren kokapena erakusten duen mapa, markoa»

Nabigatzailearen tresnak

  1. Ireki garapen-tresnak (F12). Hautatu <iframe> elementua Elementuak fitxan, eta ireki Irisgarritasuna panela.
  2. Egiaztatu Izena (Name) eremua title atribututik datorrela eta testuak edukia deskribatzen duela.
  3. Kontsolan, [...document.querySelectorAll('iframe:not([title])')] aginduak title gabeko markoak erakusten ditu.

Balidazio automatikoa

  1. axe DevTools-ek izenik gabeko iframe elementuak hautematen ditu (frame-title araua). Baita izen bera dutenak ere (frame-title-unique araua).
  2. Ez ditu hautematen izenburu generikoak edo ingelesezkoak, hala nola «iframe», «Edukia» edo «YouTube video player». Testuaren kalitatea eskuz berrikusten da.

Auditorietako ohiko akatsak

  • Bideoen eta mapen txertatze-kodeak bere horretan kopiatuta, title gabe edo zerbitzuaren ingelesezko testuarekin.
  • Barruan zer dagoen esaten ez duten izenburu generikoak, hala nola «iframe», «Mapa» edo «Kanpoko edukia».
  • name erabiltzea, markoari izena ematen diola uste izanda. Scriptetarako eta esteken helburuetarako baino ez du balio, eta erabiltzaileak ez du entzuten.
  • Erabiltzailearentzako edukirik ez duten marko teknikoak, hala nola jarraipenekoak edo publizitatekoak, irakurgailuak iragartzen dituenak. hidden edo display: none erabiliz ezkutatu behar dira.
Ikusi W3Cren testu osoa (euskarazko itzulpena)

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

Aplikagarritasuna

HTML dokumentuak, iframe elementuak erabiltzen dituztenak

Deskribapena

Teknika honen helburua iframe elementuaren title atributuaren erabilera erakustea da, haren edukia deskribatzeko. Horrek etiketa bat ematen dio markoari, erabiltzaileek erabaki dezaten zein markotan sartu xehetasunez arakatzeko. Ez du etiketatzen iframe barruan dagoen edukia.

title atributuak iframe elementuak etiketatzen ditu, eta desberdina da title elementutik, dokumentuak etiketatzen baititu. Biak eman behar dira; lehenengoak iframe elementuen arteko nabigazioa errazten du, eta bigarrenak argitzen du zein den erabiltzailearen uneko orria.

title atributua ez da name atributuaren baliokidea. title atributuak erabiltzaileentzat etiketatzen du markoa; name atributuak, berriz, scriptentzat eta leihoen helburuentzat. name ez zaio erabiltzaileari aurkezten; title bakarrik aurkezten zaio.

Adibideak

title atributua iframe batean erabiltzea iframe elementuaren edukia deskribatzeko

<!doctype html>
<html lang="en">
<head>
   <title>A document using an iframe</title>
</head>
...
<iframe src="banner-ad.html" name="ad-iframe" title="Advertisement"></iframe>
...
</html>

Probak

Prozedura

  1. Egiaztatu HTML iturburu-kodeko iframe elementu bakoitzak title atributu bat duela.
  2. Egiaztatu title atributuak iframe elementuaren edukia deskribatzen duen testu bat duela.

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