Addaw, joan hasierara Egin dohaintza

3. ikasgaia (10 guztira) · 14 min irakurtzeko · Berrikuspen-data: 26/10/2026

Arau-motor batek nola ikusten duen orria: DOMa, irisgarritasun-zuhaitza eta analisiaren unea

Ikasgai ireki bat irakurtzen ari zara. Matrikulatu testak eta ariketak egiteko, zure aurrerapena gordetzeko eta ziurtagiria lortzeko.

Matrikulatu · 4. maila (49 €)

Aurreko ikasgaian ikusi genuen bezala, tresna automatiko batek mekanikoki egiazta daitekeena baino ezin du egiaztatu. Haren emaitzak interpretatzeko, gainera, jakin behar da zer ikusten duen zehazki: ez garapen-taldearen kodea, ezta erabiltzailearen pantaila ere, baizik eta DOMaren eta estilo kalkulatuen argazki bat une jakin batean. Ikasgai honek kutxa irekitzen du: zer aztertzen duen motorrak, nola dagoen eraikita arau bat, nola kalkulatzen dituen izen irisgarria eta kontrastea, eta zer geratzen zaion kanpoan. Horrekin ulertuko duzu positibo eta negatibo faltsu askoren jatorria.

Iturburu-kodetik irisgarritasun-zuhaitzera

Zerbitzariak bidaltzen duenaren eta pantaila-irakurgailu batek jasotzen duenaren artean lau geruza daude, eta tresna bakoitzak horietako batean lan egiten du:

  1. Iturburu-kodea: zerbitzariak itzultzen duen HTMLa (Ctrl + U sakatuta ikusten duzuna). Orri bakarreko aplikazio batean, <div id="app"> huts bat baino apur bat gehiago izan daiteke.
  2. DOMa: nabigatzaileak HTMLa aztertu eta JavaScript exekutatu ondoren eraikitzen duen nodo-zuhaitza. Elementuak panelak erakusten duena da, eta elkarreragin bakoitzarekin aldatzen da.
  3. Estilo kalkulatuak: elementu bakoitzerako CSS kaskadaren azken emaitza (kolorea, tamaina, ikusgaitasuna, posizioa).
  4. Irisgarritasun-zuhaitza: nabigatzaileak laguntza-teknologiei erakusten diena, sistema eragilearen irisgarritasun-APIen bidez (UI Automation eta IAccessible2 Windowsen, NSAccessibility macOSen, AT-SPI Linuxen): objektu bakoitzaren funtzioa, izena, egoera eta erlazioak.

axe-core edo IBM Equal Accessen motorra bezalako arau-motorrak JavaScript gisa exekutatzen dira orriaren barruan. DOMa eta estilo kalkulatuak irakurtzen dituzte, eta haiekin irisgarritasun-zuhaitzaren beren hurbilketa berreraikitzen dute: ez dute kontsultatzen nabigatzaileak sortzen duena. Horregatik, axe-k kalkulatzen duen izen irisgarria, muturreko kasuetan, ez dator bat beti Chromen Accessibility panelak erakusten duenarekin edo NVDAk iragartzen duenarekin. Nu HTML balidatzaileak, aldiz, iturburu-kodea aztertzen du URL bat ematen diozunean: ez du JavaScript exekutatzen, eta ez du azken DOMa ikusten.

Adibidea

Erakunde baten aurretiko hitzorduen ataria JavaScript framework batekin egina dago. Hau da haren iturburu-kodea:

<body>
  <div id="app"></div>
  <script src="/assets/main.js"></script>
</body>

Nu HTML Checkerrean URL bidez balidatuta, ez da formularioaren arazorik agertzen, zerbitzatutako kodean ez dagoelako. Balidatzeko, sortutako DOMaren HTMLa kopiatu behar da (Elementuak panelean, «Kopiatu elementua») eta balidatzailearen testu-sarreran itsatsi. axe-k, berriz, formularioa aztertzen du, errendatutako DOMaren gainean lan egiten duelako.

Infografia · Prozesua

Arau-motor batek nola aztertzen duen orri bat

Errendatutako DOMetik emaitzara: urrats bakoitzak positibo edo negatibo faltsu mota bat azaltzen du

  1. 1. urratsa: 1. Kargatu eta errendatuNabigatzaileak DOMa eraikitzen du, JavaScript exekutatzen du eta estiloak kalkulatzen ditu
  2. 2. urratsa: 2. Egoera finkatuUne horretan irekita, kargatuta edo ikusgai ez dagoena ez da aztertzen
  3. 3. urratsa: 3. Elementuak hautatuArau bakoitzak aukeratzen du zer elementuri aplikatzen zaion; bat ere ez badago, ez da aplikagarria
  4. 4. urratsa: 4. Egiaztapenak exekutatuAtributuak, izen irisgarria, funtzioak eta kalkulatutako kontrastea; inoiz ez esanahia
  5. 5. urratsa: 5. SailkatuGainditzen du, huts egiten du, berrikusi behar da edo ez da aplikagarria, elementuz elementu
  6. 6. urratsa: 6. JakinaraziAraua, hautatzailea, kodea eta etiketatutako WCAG irizpidea, egiaztatzeko zain
ADDAW · Irisgarritasun-ikastaroak
Irakurri infografia testu gisa

Sekuentzian dauden sei urratseko prozesua. 1. urratsa, kargatu eta errendatu: nabigatzaileak DOMa eraikitzen du, JavaScript exekutatzen du eta estiloak kalkulatzen ditu. 2. urratsa, egoera finkatu: analisia argazki bat da, eta une horretan irekita, kargatuta edo ikusgai ez dagoena ez da aztertzen. 3. urratsa, elementuak hautatu: arau bakoitzak aukeratzen du zer elementuri aplikatzen zaion, eta bat ere ez badago, emaitza «ez da aplikagarria» da. 4. urratsa, egiaztapenak exekutatu: atributuak, kalkulatutako izen irisgarria, funtzioak eta estiloetatik abiatutako kontrastea, esanahia ebaluatu gabe. 5. urratsa, elementu bakoitza sailkatu: gainditzen du, huts egiten du, berrikusi behar da edo ez da aplikagarria. 6. urratsa, jakinarazi: arauaren identifikatzailea, hautatzailea, kode-zatia eta araua zer WCAG irizpiderekin dagoen etiketatuta, auditoreak egiaztatu behar duena.

Arau baten anatomia

Arau automatiko guztiek eskema bera jarraitzen dute, bai axe-coren, bai lehen ikasgaian ikusi genuen W3Cren ACT Rules formatuan:

  • Aplikagarritasuna: zer elementuri aplikatzen zaien araua. Adibidez, image-alt ezkutatuta ez dauden img elementuei aplikatzen zaie. Bat ere ez badago, emaitza «ez da aplikagarria» da.
  • Egiaztapenak: axe-n hiru motatan biltzen dira: any (nahikoa da bat gainditzea: img-ak alt du, edo aria-label, edo aria-labelledby baliozkoa, edo aurkezpen-funtzioa), all (guztiek gainditu behar dute) eta none (bat ere ez da gertatu behar, ARIA atributu debekatu bat adibidez).
  • Elementu bakoitzeko emaitza: gainditzen du, huts egiten du edo, egiaztapenen batek erabaki ezin badu, «berrikusi behar da» (incomplete).

Garrantzitsua da inongo egiaztapenen parte ez dena: esanahia. button-name arauak gainditu egiten du botoiak barne-testua, aria-label, testura seinalatzen duen aria-labelledby edo title badu. «Botoia1» edo «Click» izeneko botoi batek «Eskatu hitzordua» izeneko batek bezala gainditzen du, zehazki.

Nola kalkulatzen duen izen irisgarria

Izen irisgarria W3Cren Accessible Name and Description Computation espezifikazioaren (accname 1.2) eta lengoaia bakoitzaren arauen (HTML-AAM) arabera kalkulatzen da. Sinplifikatuz, hau da lehentasun-ordena:

  1. aria-labelledby (erreferentziatutako testua ezkutuan egon arren).
  2. aria-label.
  3. Lengoaiaren mekanismo natiboa: lotutako label-a, alt, caption, legend, input motako botoi baten value.
  4. Elementuaren beraren edukia, funtzioak ahalbidetzen duenean (botoiak, estekak, izenburuak, gelaxkak).
  5. title eta, azken baliabide gisa eremuetan, placeholder.

Ondorio praktikoa da lehenik doanak atzetik doana ordezten duela. aria-label batek botoiaren testu ikusgaia ezkutatzen du, eta tresnak izena badagoela bakarrik egiaztatzen du:

<!-- button-name gainditzen du, baina izenak ez du testu ikusgaia barne hartzen -->
<button type="submit" aria-label="Bidali formularioa">Bilatu</button>

<!-- Zuzena: izena testu ikusgaitik dator -->
<button type="submit">Bilatu</button>

Ahots bidezko kontrola erabiltzen duenak «sakatu Bilatu» esango du, eta ez da ezer gertatuko, izena «Bidali formularioa» delako: ez du betetzen 2.5.3 Etiketa izenean. axe-k badu kasu honetarako arau bat (label-content-name-mismatch), baina esperimentala da eta lehenespenez desaktibatuta dator; beraz, praktikan negatibo faltsu bat da.

Funtsezko puntua

Izenei buruzko emaitza batez zalantza duzunean, ez eztabaidatu tresnarekin: ireki Chromen Accessibility panela (edo Firefoxen irisgarritasun-ikuskatzailea), hautatu elementua, eta begiratu nabigatzaileak kalkulatutako izena eta zer atribututatik datorren. Hori da laguntza-teknologiek jasoko duten izena.

Nola kalkulatzen duen kontrastea

Kontraste-araurako, motorrak testuaren kolore kalkulatua lortzen du (haren opakutasuna barne) eta atzean zer dagoen bilatzen du: puntu horretan pilatutako elementuak zeharkatzen ditu eta geruza erdi-gardenak konbinatzen ditu hondo opaku batera iritsi arte. Ondoren, bi koloreen luminantzia erlatiboa kalkulatzen du WCAG 2.x-en formularekin, eta atalasea tamainaren arabera erabakitzen du: 4,5:1 testu arruntarentzat eta 3:1 testu handiarentzat; WCAGek testu handitzat hartzen ditu 18 puntu edo 14 puntu lodian (24 px eta 18,66 px CSS inguru).

Kalkuluak ondo funtzionatzen du kolore lauekin. Testuaren atzean irudi bat, gradiente bat, sasielementu bat, testu-itzal bat edo gainjarritako elementu bat dagoenean, motorrak ezin du hondoko kolorea ziurtatu, eta «berrikusi behar da» gisa uzten du. Gainera, analisiaren unean dagoen egoera bakarrik neurtzen du: fokua edo erakuslea gainetik pasatzea neurtu nahi baduzu, egoera hori behartu behar duzu (Chromen, Estiloak panela, :hov botoia, «Behartu elementuaren egoera») eta berriro aztertu. Tamainaren muturreko kasuetan, hala nola 18 px-ko testu lodi batean, berretsi eskuz tamaina kalkulatua, tresnak aplikatu duen atalasea onartu aurretik.

Gune itsuak: motorra ikustera iristen ez dena

«Aztertu» sakatzen duzunean DOMean, edo egoera egokian, ez dagoen guztia ez da existitzen tresnarentzat.

EgoeraZer egiten duen motorrakZer egin behar duzun
Elkarreragitean agertzen diren menuak, leiho modalak, formularioko erroreak edo emaitzakUne horretan irekita badaude bakarrik aztertzen ditu; display: none duten elementuei ez die jaramonik egitenOrria laginaren egoera bakoitzean jarri eta berriro aztertu
Modu diferituan kargatutako edukia (korritze infinitua, karga alferra)Dagoeneko kargatu dena bakarrik aztertzen duAmaieraraino korritu edo karga eragin aztertu aurretik
Iframeak, batez ere hirugarrenenak (mapak, txatak, ordainketa-pasabideak)Luzapenak motorra marko bakoitzean txertatzen saiatzen dira, baina segurtasun- edo karga-murrizketek kanpoan utz ditzaketeEmaitzetan egiaztatu markoaren edukia aztertu dela
Shadow DOM duten osagaiakaxe-k Shadow DOM irekia zeharkatzen du; itxia ez dago eskuragarri JavaScriptetikErro itxia duten osagaiak eskuz berrikusi
canvas, WebGL, bideoa eta audioaEz du haien edukia ikusten; gehienez ere, eduki alternatibo bat edo azpititulu-pista bat badagoenEskuzko ebaluazio osoa
Diseinu moldagarriaUneko leiho-tamainako diseinua aztertzen duMugikorreko zabaleran (320 px CSS) eta mahaigaineko zabaleran errepikatu
Orriak alderatzen dituzten irizpideak (3.2.3, 3.2.4, 3.2.6)Orri bakoitza bere aldetik aztertzen du, eta ez ditu alderatzenLagina eskuz alderatu

Ohiko akatsa

Orri bakoitzaren hasierako egoera bakarrik aztertzea. Txostenak «urraketa automatikorik ez» dio hitzordua eskatzeko orrian, baina inork ez zuen egutegia ireki, inork ez zuen formulario hutsa bidali, eta inork ez zuen menua zabaldu mugikorreko zabaleran. Analisia hiru egoera horietan errepikatzean, izenik gabeko eremuak, ixteko botoi huts bat eta 2,8:1 kontrastea duen errore-mezu bat agertzen dira.

Probatu zuk zeuk

  1. Ireki goitibeherako menu bat edo leiho modal bat duen web bat, eta exekutatu axe DevTools hasierako egoeran. Idatzi urraketen eta berrikusi beharreko elementuen kopurua.
  2. Ireki menua edo leiho modala, eta aztertu berriro. Alderatu zifrak.
  3. Chromen, ireki garapen-tresnak, hautatu botoi bat Elementuak panelean eta ireki Accessibility fitxa: begiratu izen kalkulatua eta zer atribututatik datorren.

Laburpena

  • Arau-motorrek DOMa eta estilo kalkulatuak aztertzen dituzte une jakin batean, eta irisgarritasun-zuhaitzaren beren bertsioa berreraikitzen dute; Nu balidatzaileak zerbitzatutako kodea aztertzen du.
  • Arau bakoitzak aplikagarritasun bat eta egiaztapen batzuk ditu (any, all, none); bat ere ez da esanahia ebaluatzen duena.
  • Izen irisgarriak lehentasun-ordena bati jarraitzen dio (aria-labelledby, aria-label, mekanismo natiboa, edukia, title): lehenengoak hurrengoa ordezten du, eta tresnak ikusten ez dituen 2.5.3 irizpideko akatsak eragin ditzake.
  • Kontrastea ondo kalkulatzen da kolore lauen gainean; irudiek, gradienteek, gainjartzeek eta egoerek eskuzko neurketa eskatzen dute.
  • Elkarreragin-egoerak, karga diferitua, iframeak, Shadow DOM itxia, canvas-a, diseinu moldagarria eta orrien arteko alderaketak eskuz estali behar diren gune itsuak dira.

Ikastaro honetako 2 ikasgai irakurri dituzu: ez itzazu galdu

Sortu zure kontua, gorde irakurri duzuna eta jarraitu ikastaroarekin, osorik:

  • Ikasgai honetako testa (3 galdera), ikasitakoa egiaztatzeko
  • Benetako orriekin egindako ariketa praktikoak
  • Zure aurrerapena gordeta: utzi zenuen lekutik jarraituko duzu, edozein gailutatik
  • Ikastaroaren egiaztagiria, orduekin, eta 4. mailako ziurtagiria azterketa gainditzen duzunean

Zure Google kontuarekin edo zure posta elektronikoarekin bakarrik sartzen zara. Ez duzu pasahitzik behar.

Matrikulatu · 4. maila (49 €)