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

Tècnica ARIA WCAG 2.2

ARIA17Agrupar camps relacionats amb role="group" o role="radiogroup"

Nom oficial al W3C: Utilitzar funcions (rols) d'agrupació per identificar els controls de formulari relacionats

Versión en castellano

En poques paraules

Alguns camps d'un formulari només tenen sentit junts, com el dia, el mes i l'any d'una data. Amb role="group" es marquen com un grup amb nom propi. Per a opcions de les quals només se'n tria una, s'utilitza role="radiogroup". És una alternativa a fieldset i legend.

Per què és important

Qui veu el formulari entén que «Dia», «Mes» i «Any» formen la data de naixement. Qui utilitza un lector de pantalla recorre els camps d'un en un. Sense grup, sent «Dia» i no sap de quina data es tracta.

Amb el grup, el lector n'anuncia el nom en entrar-hi, per exemple «Data de naixement, grup». Així cada camp s'entén en el seu context.

Com es fa

  1. Si podeu, utilitzeu <fieldset> i <legend> (tècnica H71). Aquesta tècnica serveix quan el disseny ho complica.
  2. Emboliqueu els camps relacionats en un contenidor amb role="group".
  3. Si són opcions de les quals només se'n tria una, utilitzeu role="radiogroup".
  4. Doneu nom al grup amb aria-labelledby, apuntant al seu títol visible, o amb aria-label.
  5. Mantingueu també una etiqueta per a cada camp del grup.
  6. No poseu tot el formulari en un sol grup. Agrupeu només el que va junt.

Com comprovar-ho

  1. Localitzeu els conjunts de camps que necessiten un títol comú per entendre's.
  2. Comproveu que són dins d'un element amb role="group" o, si són opcions, amb role="radiogroup".
  3. Comproveu que aquest grup té nom amb aria-labelledby o aria-label.
  4. Entreu al grup amb el tabulador i un lector de pantalla. Ha d'anunciar el nom del grup.

Exemple

Data de naixement en tres camps, agrupats sota un mateix nom.

<div role="group" aria-labelledby="tit-fecha">
  <p id="tit-fecha">Data de naixement</p>
  <label for="dia">Dia</label>
  <input id="dia" inputmode="numeric" size="2">
  <label for="mes">Mes</label>
  <input id="mes" inputmode="numeric" size="2">
  <label for="anio">Any</label>
  <input id="anio" inputmode="numeric" size="4">
</div>
Veure el text complet del W3C (traducció al català)

Aquesta és una traducció no oficial al català de la tècnica ARIA17 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 que admeten Accessible Rich Internet Applications (WAI-ARIA).

Descripció

L'objectiu d'aquesta tècnica és marcar un conjunt de controls relacionats dins d'un formulari com un grup. Qualsevol etiqueta associada al grup serveix també com a etiqueta comuna o qualificador de cadascun dels controls del grup. Les tecnologies de suport poden indicar l'inici i el final del grup, així com la seva etiqueta, a mesura que s'hi entra i se'n surt. Es tracta d'una alternativa viable per agrupar controls de formulari per programari quan el disseny de la interfície d'usuari dificulta emprar la tècnica de fieldset / legend (H71).

Per a un grup de botons d'opció s'ha d'utilitzar role="radiogroup" en lloc de role="group".

El grup es pot etiquetar mitjançant aria-labelledby.

Aquesta tècnica no està pensada per embolicar tots els controls d'un formulari dins d'un únic contenidor amb role="group".

Exemples

Número de la seguretat social

Els camps d'un número de la seguretat social, que té nou dígits i es divideix en tres segments, es poden agrupar mitjançant role="group".

<div role="group" aria-labelledby="ssn1">
  <span id="ssn1">Social Security Number</span>
  <span style="color: #D90D0D;"> (required)</span>
  <input size="3" type="text" aria-required="true" title="First 3 digits">-
  <input size="2" type="text" aria-required="true" title="Next 2 digits">-
  <input size="4" type="text" aria-required="true" title="Last 4 digits">
</div>

Exemple funcional: Grups de camps de diverses parts.

Identificar grups de botons d'opció

Aquest exemple mostra l'ús de role=radiogroup. Observeu també que els botons d'opció són controls personalitzats amb role=radio. Opcionalment, es pot emprar CSS per col·locar una vora al voltant dels grups d'aquests camps i reforçar visualment la relació de grup. Les propietats CSS estan disponibles sota el formulari.

<h3>Set Alerts for your Account</h3>
<div role="radiogroup" aria-labelledby="alert1">
  <p id="alert1">Send an alert when balance exceeds $3,000</p>
  <div>
    <span role="radio" aria-checked="false" aria-labelledby="a1r1" name="a1radio"></span>
    <span id="a1r1">Yes</span>
  </div>
  <div>
    <span role="radio" aria-checked="false" aria-labelledby="a1r2" name="a1radio"></span>
    <span id="a1r2">No</span>
  </div>
</div>
<div role="radiogroup" aria-checked="false" aria-labelledby="alert2">
  <p id="alert2">Send an alert when a charge exceeds $250</p>
  <div>
    <span role="radio" aria-checked="false" aria-labelledby="a2r1" name="a2radio"></span>
    <span id="a2r1">Yes</span>
  </div>
  <div>
    <span role="radio" aria-checked="false" aria-labelledby="a2r2" name="a2radio"></span>
    <span id="a2r2">No</span>
   </div>
</div>
<input type="submit" value="Continue" name="continue_btn">

Definició d'estil CSS relacionada per col·locar una vora al voltant del grup de camps:

div[role=radiogroup] {
  border: black thin solid;
}

Exemple funcional: utilitzar funcions d'agrupació per identificar controls de formulari relacionats.

L'script necessari perquè els span funcionin realment com a botons d'opció no s'inclou en aquest exemple. Per a un exemple funcional similar, encara que codificat d'una manera lleugerament diferent, consulteu l'exemple Radio Group Example Using aria-activedescendant (exemple de grup de botons d'opció amb aria-activedescendant) de les ARIA Authoring Practices.

Proves

Procediment

Per als grups de controls relacionats en què les etiquetes individuals de cada control no proporcionen una descripció suficient i cal una descripció addicional a nivell de grup:

  1. Comprovar que el grup d'elements input o select relacionats lògicament és contingut dins d'un element amb role=group o role=radiogroup, segons el tipus d'elements que contingui el grup.
  2. Comprovar que aquest grup té un nom accessible definit mitjançant aria-label o aria-labelledby.

Resultats esperats

  • Les comprovacions núm. 1 i núm. 2 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 ARIA17 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.