embed-text-alternative-quality
La alternativa textual de <embed> debe ser adecuada (revisión manual)
Marca los elementos <embed> con un nombre detectado para revisión manual de su idoneidad.
Ámbito de aplicación. Se aplica a los elementos <embed> que ya tienen una alternativa textual: un aria-label no vacío, un aria-labelledby que se resuelve en texto no vacío, o un title no vacío. Un aria-labelledby que apunta a un id inexistente no se resuelve en nada y, por lo tanto, no es una alternativa textual que revisar; ese elemento es un fallo de embed-text-alternative-present. El elemento debe estar incluido en el árbol de accesibilidad, y role="presentation"/"none" lo saca del alcance salvo que sea enfocable, lo que restaura 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.ariaLabel,title: elaria-labely eltitledel elemento, o null cuando no los tiene.ariaLabelledBy: los ids delaria-labelledbydel elemento, o null cuando no lo tiene.ariaLabelledByText: el texto al que apuntan esos ids, o null. Solo se busca cuando el elemento no tienearia-label, ya que en ese caso esaria-labelel que da el nombre.
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
<embed src="report.pdf" type="application/pdf" title="Quarterly report PDF">
Hay un title presente: conviene confirmar que identifica el documento lo bastante bien para alguien que no puede ver el visor incrustado.
<embed src="report.pdf" type="application/pdf">
No existe aria-label, aria-labelledby resuelto ni title que revisar; eso es, en cambio, un fallo de embed-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 o hace el contenido insertado que indica el informe.
- Leer su alternativa textual (aria-label, el texto de aria-labelledby o el title, según lo da el informe).
- Comprobar que el texto dice qué es el contenido insertado o lo describe.
Se cumple. La alternativa textual identifica o describe con exactitud el contenido insertado.
No se cumple. La alternativa textual es genérica, errónea o no describe el contenido insertado, lo que incumple WCAG 1.1.1.