object-text-alternative-quality
El texto alternativo de <object> debe ser apropiado (revisión manual)
Marca elementos <object> con contenido de reserva o nombre detectado para revisión manual de equivalencia e idoneidad.
Ámbito de aplicación. Se aplica a elementos <object> que ya tienen una alternativa textual: contenido de texto de reserva, un aria-label no vacío, un aria-labelledby que resuelve a texto no vacío, o un title no vacío. Un <object> sin ninguno de estos es un fallo de object-text-alternative-present, no una cuestión de calidad. El elemento debe estar incluido en el árbol de accesibilidad, y role="presentation"/"none" lo excluye del alcance a menos que sea enfocable, lo que restaura su rol. Se deja fuera un objeto cuyo type, o en su defecto la extensión de su URL data, indica una página HTML, un PDF o texto plano, igual que lo deja fuera object-text-alternative-present: no muestra contenido no textual (ACT 8fc3b6). También un objeto Flash (type="application/x-shockwave-flash", o sin type, una URL data que termina en .swf): ningún navegador actual ejecuta Flash (el soporte terminó en 2021), así que el objeto no dibuja nada por sí mismo y el navegador muestra su contenido de reserva, HTML corriente que evalúan las demás reglas. No queda nada no textual para 1.1.1 (ACT 8fc3b6).
Resultado esperado. Se requiere revisión manual para confirmar que el texto alternativo proporcionado es preciso y apropiado.
Qué informa un hallazgo.
reasonCode:TEXT_ALTERNATIVE_REVIEW.fallbackText: el contenido de texto dentro del <object>, sin espacios al principio ni al final, onullcuando no hay ninguno.ariaLabel: el valor dearia-label, onullcuando no hay ninguno.ariaLabelledBy: el valor dearia-labelledby, los ids a los que apunta, onullcuando no hay ninguno.ariaLabelledByText: el texto de los elementos a los que apuntaaria-labelledby. Solo se busca cuando no hayaria-label;nullen caso contrario o cuando no se resuelve en nada.title: el valor detitle, onullcuando no hay ninguno.
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
<object data="sales-chart.png" type="image/png">Sales chart</object>
Hay texto de reserva presente — vale la pena confirmar que "Sales chart" es realmente equivalente a la imagen, y no solo un texto de relleno.
<object data="sales-chart.png" type="image/png"></object>
No existe contenido de reserva, nombre ARIA ni title para revisar; ese es en cambio un fallo de object-text-alternative-present.
<object data="brochure.pdf" type="application/pdf">Product brochure (PDF)</object>
Un PDF muestra texto, no contenido no textual, así que 1.1.1 no le exige nada (ACT 8fc3b6), como también lo entiende object-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 el objeto que indica el informe y anotar lo que muestra o hace (imagen, gráfico, animación, reproductor).
- Leer su alternativa textual en el informe (texto alternativo de reserva, aria-label, el texto de aria-labelledby o el title), o en el panel Accesibilidad de las herramientas para desarrolladores.
- Si la alternativa textual solo nombra el objeto, 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 objeto y da todo lo que muestra el objeto.
- Comparar: ¿el texto, junto con esa descripción si la hay, dice lo que muestra el objeto o, en un control o reproductor, para qué sirve?
Se cumple. La alternativa textual, sola o con una descripción a la que un usuario de lector de pantalla llega desde ella, describe con precisión el contenido o el propósito del objeto.
No se cumple. La alternativa textual es errónea o vaga (como «objeto» o un nombre de archivo), u omite lo que transmite el objeto y ninguna descripción accesible desde ella lo da, lo que incumple WCAG 1.1.1.