Addaw, anar a la pàgina d'inici Donar

Tècnica ARIA WCAG 2.2

ARIA5Comunicar l'estat d'un component amb atributs ARIA

Nom oficial al W3C: Utilitzar atributs d'estat i de propietat de WAI-ARIA per exposar l'estat d'un component de la interfície d'usuari

Versión en castellano

En poques paraules

Molts components canvien: un menú s'obre, un botó queda premut, un control lliscant marca un valor. Els atributs d'estat d'ARIA, com ara aria-expanded, aria-pressed o aria-valuenow, transmeten aquests canvis al lector de pantalla. Cal actualitzar-los amb JavaScript cada vegada que l'estat canvia.

Per què és important

Una persona que veu la pantalla nota que el menú s'ha desplegat o que el botó de silenci està activat. Qui utilitza un lector de pantalla (programa que llegeix en veu alta la pantalla) només sap el que el codi li diu.

Sense aquests atributs, sentirà «botó Menú» i no sabrà si el menú està obert. Si l'atribut existeix però no s'actualitza, és pitjor: rebrà informació falsa.

Com es fa

  1. Identifiqueu quins estats té el component: obert o tancat, marcat o no, valor actual.
  2. Utilitzeu l'atribut adequat: aria-expanded per a desplegables, aria-pressed per a botons d'activar i desactivar, aria-checked per a caselles pròpies i aria-selected per a pestanyes.
  3. Poseu els atributs obligatoris de cada rol. Per exemple, un role="slider" necessita aria-valuenow, i convé donar-li aria-valuemin i aria-valuemax.
  4. No utilitzeu atributs que el rol no admet. L'especificació WAI-ARIA indica quins admet cadascun.
  5. Canvieu el valor amb JavaScript en el mateix moment en què canvia el que es veu.

Com comprovar-ho

  1. Obriu les eines del navegador (F12), seleccioneu el component i mireu-ne els estats al tauler «Accessibilitat».
  2. Utilitzeu el component amb el ratolí o el teclat. Comproveu al codi que el valor de l'atribut canvia, per exemple de false a true.
  3. Reviseu que hi ha els atributs obligatoris del rol i que no en sobra cap. Eines com axe o WAVE avisen de molts d'aquests errors.
  4. Amb un lector de pantalla, activeu el component. Heu de sentir el nou estat: «premut», «expandit» o el nou valor.

Exemple

Botó per silenciar un vídeo que indica si el silenci està activat.

<button type="button" id="silencio" aria-pressed="false">Silencia</button>
<script>
  const boton = document.getElementById('silencio');
  boton.addEventListener('click', () => {
    const activo = boton.getAttribute('aria-pressed') === 'true';
    boton.setAttribute('aria-pressed', String(!activo));
  });
</script>
Veure el text complet del W3C (traducció al català)

Aquesta és una traducció no oficial al català de la tècnica ARIA5 de Techniques for WCAG 2.2, del W3C. Pot contenir errors. L'únic document oficial i normatiu és la versió original en anglès, publicada al lloc web del W3C.

Aplicabilitat

Tecnologies compatibles amb Accessible Rich Internet Applications (WAI-ARIA).

Descripció

L'objectiu d'aquesta tècnica és utilitzar els atributs d'estat i de propietat de WAI-ARIA per exposar l'estat, les propietats i els valors d'un component de la interfície d'usuari, de manera que les tecnologies de suport els puguin llegir i establir, i rebin notificació dels canvis en aquests valors. L'especificació WAI-ARIA proporciona una descripció normativa de cada atribut i del rol dels elements de la interfície d'usuari als quals dona suport. Quan les aplicacions d'internet enriquides defineixen nous components (ginys) d'interfície d'usuari, exposar els atributs d'estat i de propietat permet als usuaris entendre el component i com interactuar-hi.

Exemples

Un botó commutador

Un component amb rol button actua com a botó commutador quan implementa l'atribut aria-pressed. Quan aria-pressed és true, el botó està en estat «premut». Quan aria-pressed és false, no està premut. Si l'atribut no hi és, el botó és un simple botó d'ordre.

El fragment següent, extret dels exemples de botó de la guia de pràctiques d'autor d'ARIA (APG), mostra el marcatge WAI-ARIA d'un botó commutador per silenciar o activar l'àudio:

<a tabindex="0"
  role="button"
  id="toggle"
  aria-pressed="false">
  Mute
  ...
</a>

L'element a té un role="button" i un atribut aria-pressed. L'extracte següent del codi JavaScript d'aquest exemple actualitza el valor de l'atribut aria-pressed:

/**
* Toggles the toggle button's state between *pressed* and *not pressed*.
*
* @param {HTMLElement} button
*/
function toggleButtonState(button) {
  var isAriaPressed = button.getAttribute('aria-pressed') === 'true';
  button.setAttribute('aria-pressed', isAriaPressed ? 'false' : 'true');
  ...
}

Un control lliscant

Un component amb rol slider permet a l'usuari seleccionar un valor dins d'un interval determinat. El control lliscant representa el valor actual i l'interval de valors possibles mitjançant la mida del mateix control i la posició del tirador. Aquestes propietats del control lliscant es representen amb els atributs aria-valuemin, aria-valuemax i aria-valuenow.

El fragment següent, extret de l'exemple de control lliscant per visualitzar colors de la guia de pràctiques d'autor d'ARIA (APG), mostra el marcatge WAI-ARIA d'un dels controls lliscants:

<div id="id-red" class="color-slider-label">Red</div>
<div class="color-slider red"
  role="slider"
  tabindex="0"
  aria-valuemin="0"
  aria-valuenow="128"
  aria-valuemax="255"
  aria-labelledby="id-red">
   ...
</div>

L'extracte següent del codi JavaScript d'aquest exemple actualitza el valor de l'atribut aria-valuenow quan canvia el valor del tirador del control lliscant:

moveSliderTo(slider, value) {
  ...
  slider.sliderNode.setAttribute('aria-valuenow', value);
  ...
}

Proves

Procediment

L'especificació WAI-ARIA, secció 5.3, Categorització de rols defineix els estats i les propietats obligatoris i heretats de cada rol.

Per a un component de la interfície d'usuari que utilitza l'atribut role de WAI-ARIA:

  1. Comprovar que hi ha els estats i les propietats obligatoris per al rol.
  2. Comprovar que no hi ha cap estat o propietat de WAI-ARIA que no sigui obligatori, admès o heretat.
  3. Comprovar que els valors dels estats i les propietats s'actualitzen per reflectir l'estat actual quan el component de la interfície d'usuari canvia d'estat.

Resultats esperats

  • Les comprovacions núm. 1, núm. 2 i núm. 3 són certes.

Recursos

Com ho comprovem a ADDAW

En cada auditoria d'ADDAW revisem aquesta tècnica pàgina per pàgina i us lliurem els errors amb captures i la manera de corregir-los.

Sol·licitar una auditoria

Basat en la tècnica ARIA5 del W3C (WCAG 2.2). Explicació i exemples: ADDAW. Traducció no oficial del text del W3C © W3C, llicència de documents del W3C. Heu vist un error? Escriviu-nos.