ARIA Authoring Practices Guide

ARIA-spesifikaatio määrittelee roolien, tilojen ja ominaisuuksien sanaston. ARIA Authoring Practices Guide selittää, miten niitä käytetään käytännössä: mitä näppäimistövuorovaikutuksia kukin malli edellyttää, miten kohdistus liikkuu widgetissä, mitä ilmoitetaan tilan muuttuessa ja miltä DOM:n pitäisi näyttää.

Mitä APG sisältää

APG dokumentoi jokaisen ARIA-spesifikaation tueksi kirjoitetun widgetimallin kanonisen toteutuksen:

• Yhdistelmäruudut (automaattinen täydennys -malli, jonka näppäimistökäyttäytymisen lähes kaikki toteuttavat väärin).
• Dialogit — modaaliset ja ei-modaaliset, täydellisellä kohdistusloukulla ja kohdistuksen palautuksella sulkemisen yhteydessä.
• Paljastavat widgetit (yksinkertainen näytä/piilota-malli).
• Valikot ja valikkorimt — sellaisia, joihin tarvitaan nuolinäppäinnavigointia eikä pelkkää tabulaatoria.
• Välilehdet — välilehti/välilehtipaneeli-parit näppäimistön nuolinäppäinnavigoinnilla sekä automaattisella ja manuaalisella aktivointisematiikalla.
• Puunäkymät — tiedostopuu-tyylinen hierarkkinen navigointi.
• Luetteloruudut — yksi- ja monivalinta.
• Pyöritinpainikkeet, liukusäätimet, karusellit ja kymmenkunta muuta.

Jokaisella mallisivulla on kolme osaa: toimiva reaaliaikainen esimerkki, näppäimistövuorovaikutustaulukko ja käytetyt tarkat ARIA-attribuutit. Sivustolla on myös kiintopistemalit — ohjeet <header>, <nav>, <main> -elementeille ja niihin kuvautuville ARIA-rooleille — sekä osa virheellisistä käytännöistä, jossa selitetään, mitä ei tule tehdä.

Milloin siihen kannattaa turvautua

APG on hyödyllisin silloin, kun olet rakentamassa widgettia, jolle ei ole natiivielementtiä. Ennen kuin kirjoitat yhtäkään koodiriviä, tarkista onko mallille APG-toteutus. Lähes aina:

• Tarvittavat näppäimistövuorovaikutukset on jo määritelty.
• DOM-rakenne on jo dokumentoitu.
• ARIA-attribuutit on jo selvitetty.

Tämän vaiheen ohittaminen on syynä siihen, että tiimit toimittavat “saavutettavia” widgettejä, jotka hämmentävät ruudunlukuohjelmia tavoin, joita mikään automatisoitu työkalu ei havaitse. APG on ero sellaisen yhdistelmäruudun välillä, joka toimii kaikille, ja sellaisen, joka kääntää mutta hajoaa ruudunlukuohjelman käyttäjille.

Mitä APG nimenomaisesti ei ole

APG ei ole normatiivinen spesifikaatio. Normatiiviset asiakirjat ovat itse ARIA-spesifikaatio ja WCAG. APG on ohjeistus: widgetin toteuttaminen täsmälleen APG:n osoittamalla tavalla on suositeltu polku, muttei ainoa sallittu polku. Siitä poikkeaminen ilman dokumentoitua syytä on kuitenkin merkki siitä, että mallia ei ehkä ymmärretä täysin.

APG ei myöskään korvaa natiivi-HTML:ää. Jos <select> toimii pudotusvalikossasi, käytä <select> — älä turvaudu APG:n yhdistelmäruutumalliin vain siksi, että se kuulostaa edistyneemmältä.