canvas-text-alternative-quality
La alternativa textual de <canvas> debe ser adecuada (revisión manual)
Señala los elementos <canvas> con una alternativa textual detectada para que una persona evalúe su equivalencia e idoneidad.
Ámbito de aplicación. Se aplica a elementos <canvas> que ya tienen una alternativa textual: contenido de reserva dentro del elemento, un nombre ARIA o un title. Un <canvas> que no tenga nada de eso no tiene alternativa cuya calidad pueda juzgarse; ese caso es un fallo de canvas-text-alternative-present. El elemento debe estar incluido en el árbol de accesibilidad, y role="presentation"/"none" lo saca del alcance a menos que sea enfocable, lo que restablece su rol.
Resultado esperado. Se requiere revisión manual para confirmar que la alternativa textual proporcionada es precisa y adecuada.
Qué informa un hallazgo.
reasonCode:TEXT_ALTERNATIVE_REVIEW.value: la alternativa textual que revisar. Cuando el contenido de reserva no tiene texto propio pero contiene una imagen con texto alternativo o un elemento con aria-label, es el marcadorfallback-content.mechanism: de dónde procede la alternativa textual:canvas-fallback(contenido dentro del <canvas>),aria-labelledby,aria-labelotitle.flags: notas sobre cómo se encontró la alternativa textual, comotitle-usedcuando solo la proporciona el atributo title.
Estos campos de data.details ayudan a leer y reproducir un hallazgo. Salvo reasonCode y los pocos campos que Esquema de salida indica como estables, no son un contrato estable: un campo puede cambiar de nombre o desaparecer en una versión menor, así que no construyas sobre ellos.
Ejemplos
<canvas width="400" height="200">Bar chart</canvas>
El texto de reserva "Bar chart" está presente pero es genérico: conviene confirmar que transmite los datos reales, no solo el tipo de gráfico.
<canvas width="400" height="200"></canvas>
No existe contenido de reserva, nombre ARIA ni title que revisar; ese caso es en cambio un fallo de canvas-text-alternative-present.
Cómo comprobarlo
Cuando esta regla no puede decidir, informa cantTell y deja la pregunta a una persona. Cada pregunta que puede plantear aparece aquí bajo su código de motivo, con los pasos para responderla. Un hallazgo lleva los mismos pasos en howToCheck, en el idioma del análisis. Consulta Esquema de salida.
TEXT_ALTERNATIVE_REVIEW
- Observar lo que muestra en pantalla el canvas que indica el informe, incluidos los cambios mientras lo usa.
- Leer su alternativa textual (el valor que da el informe, o su contenido alternativo y su nombre en el panel Accesibilidad).
- Si la alternativa textual solo nombra el lienzo, como es habitual en gráficos y diagramas, los detalles pueden estar en otro sitio: en un pie, un texto o una tabla junto a él, o en un enlace al lado. Solo cuenta si un usuario de lector de pantalla puede encontrarlo desde el lienzo y da todo lo que muestra el lienzo.
- Comprobar que el texto, junto con esa descripción si la hay, transmite la misma información o propósito que el dibujo, y se actualiza si el dibujo cambia.
Se cumple. La alternativa textual, sola o con una descripción a la que un usuario de lector de pantalla llega desde ella, da la misma información o propósito que lo que muestra el lienzo.
No se cumple. Ni la alternativa textual ni una descripción accesible desde ella dan la información que muestra el lienzo, o el texto es vago o erróneo, lo que incumple WCAG 1.1.1.