Técnica ARIA WCAG 2.2
ARIA17Usar funciones (roles) de agrupación para identificar los controles de formulario relacionados
En resumen
Cuando varios campos de un formulario forman una unidad lógica, como las tres partes de un número de identificación o un conjunto de botones de opción, las etiquetas individuales no bastan para entenderlos fuera de contexto. Esta técnica usa role="group" o role="radiogroup", junto con un nombre accesible, para que los lectores de pantalla anuncien la entrada y salida del grupo y su etiqueta común. Es la alternativa a fieldset y legend cuando el diseño no permite usarlos.
Aplicabilidad
Tecnologías que admiten Accessible Rich Internet Applications (WAI-ARIA).
Descripción
El objetivo de esta técnica es marcar un conjunto de controles relacionados dentro de un formulario como un grupo. Cualquier etiqueta asociada al grupo sirve también como etiqueta común o calificador de cada uno de los controles del grupo. Las tecnologías de asistencia pueden indicar el inicio y el final del grupo, así como su etiqueta, a medida que se entra y se sale de él. Se trata de una alternativa viable para agrupar controles de formulario por software cuando el diseño de la interfaz de usuario dificulta emplear la técnica de fieldset / legend (H71).
Para un grupo de botones de opción debe usarse role="radiogroup" en lugar de role="group".
El grupo puede etiquetarse mediante aria-labelledby.
Esta técnica no está pensada para envolver todos los controles de un formulario dentro de un único contenedor con role="group".
Ejemplos
Número de la seguridad social
Los campos de un número de la seguridad social, que tiene nueve dígitos y se divide en tres segmentos, pueden agruparse mediante 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>
Ejemplo funcional: Grupos de campos de varias partes.
Identificar grupos de botones de opción
Este ejemplo muestra el uso de role=radiogroup. Observe también que los botones de opción son controles personalizados con role=radio. Opcionalmente, puede emplearse CSS para colocar un borde alrededor de los grupos de estos campos y reforzar visualmente la relación de grupo. Las propiedades CSS están disponibles debajo del formulario.
<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ón de estilo CSS relacionada para colocar un borde alrededor del grupo de campos:
div[role=radiogroup] {
border: black thin solid;
}
Ejemplo funcional: usar funciones de agrupación para identificar controles de formulario relacionados.
span funcionen realmente como botones de opción no se incluye en este ejemplo. Para un ejemplo funcional similar, aunque codificado de forma ligeramente distinta, consulte el ejemplo Radio Group Example Using aria-activedescendant (ejemplo de grupo de botones de opción con aria-activedescendant) de las ARIA Authoring Practices.
Pruebas
Procedimiento
Para los grupos de controles relacionados en los que las etiquetas individuales de cada control no proporcionan una descripción suficiente y se necesita una descripción adicional a nivel de grupo:
- Comprobar que el grupo de elementos input o select relacionados lógicamente está contenido dentro de un elemento con
role=grouporole=radiogroup, según el tipo de elementos que contenga el grupo. - Comprobar que este grupo tiene un nombre accesible definido mediante
aria-labeloaria-labelledby.
Resultados esperados
- Las comprobaciones n.º 1 y n.º 2 son verdaderas.
Recursos
Cómo lo comprobamos en ADDAW
En las auditorías de accesibilidad de ADDAW revisamos cada criterio de conformidad siguiendo este catálogo de técnicas: comprobamos si la web aplica una técnica suficiente y documentamos cada fallo común con capturas y el código afectado, para que el equipo de desarrollo sepa exactamente qué corregir. Los informes siguen la metodología del Observatorio de Accesibilidad y la norma UNE-EN 301 549.
Fuente y licencia
Traducción al español, no oficial, realizada por ADDAW a partir de la técnica ARIA17 del documento «Techniques for WCAG 2.2» del W3C (versión del repositorio público del W3C a 22/10/2026). Copyright © W3C® (MIT, ERCIM, Keio, Beihang). Se publica conforme a la licencia de documentos del W3C. El texto normativo de referencia es el original en inglés; si detecta un error en la traducción, escríbanos.