Técnica Técnicas generales WCAG 2.2
G10Crear componentes con una tecnología compatible con la API de accesibilidad de las plataformas de los agentes de usuario, que exponga nombre y función, permita establecer las propiedades configurables por el usuario y notifique los cambios
En resumen
Cuando el contenido se construye con un lenguaje de programación en lugar de con marcado, esta técnica pide usar componentes estándar que ya se comunican con la API de accesibilidad de la plataforma, o bien dotar a los componentes nuevos de esa compatibilidad. Así los lectores de pantalla y otras tecnologías de asistencia conocen el nombre, la función, el valor y los cambios de cada control. Útil para desarrolladores de applets, aplicaciones y controles a medida.
Aplicabilidad
Tecnologías de programación que disponen de componentes estándar programados para comunicarse con las API de accesibilidad.
Descripción
El objetivo de esta técnica es permitir que la tecnología de asistencia comprenda el contenido web, de forma que pueda transmitir al usuario información equivalente a través de una interfaz de usuario alternativa.
A veces el contenido no se crea con un lenguaje de marcado, sino con un lenguaje de programación o con herramientas. En muchos casos, estas tecnologías disponen de componentes de interfaz que ya están programados para comunicarse con las API de accesibilidad. Si el autor utiliza estos componentes y rellena sus propiedades (por ejemplo, el nombre, etc.), los componentes de interfaz de usuario resultantes serán accesibles para la tecnología de asistencia.
Sin embargo, si el autor quiere crear un componente de interfaz de usuario nuevo y no puede utilizar componentes estándar, debe asegurarse de añadir por sí mismo las medidas de accesibilidad e implementarlas de forma compatible con la API de accesibilidad.
Una vez terminado, el componente personalizado debe probarse para verificar que es compatible con la accesibilidad.
Ejemplos
- Una página web utiliza Java para crear un applet. Un grupo de autores quiere crear un tipo de componente de interfaz totalmente nuevo, por lo que no puede utilizar los objetos Java existentes. Usan las clases Swing de Java para crear su componente, porque dichas clases ya incluyen mecanismos para conectarse a distintas API de accesibilidad. Mediante las clases Swing de Java consiguen crear un componente de interfaz que expone su nombre y su función, cuyo valor puede establecer la tecnología de asistencia y que avisa a la tecnología de asistencia de cualquier actualización.
Pruebas
Procedimiento
- Mostrar el contenido con un agente de usuario accesible.
- Utilizar una herramienta de accesibilidad diseñada para la API de accesibilidad del agente de usuario para evaluar cada componente de interfaz de usuario.
- Comprobar que la herramienta encuentra el nombre y la función de cada componente de interfaz de usuario.
- Cambiar los valores del componente.
- Comprobar que la herramienta de accesibilidad recibe la notificación del cambio.
- Comprobar que el componente funciona con las tecnologías de asistencia.
Resultados esperados
- Las comprobaciones n.º 3, n.º 5 y n.º 6 son verdaderas para cada componente de interfaz de usuario.
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 G10 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.
