embed-text-alternative-quality
<embed>の代替テキストは適切である必要があります(手動レビュー)
名前が検出された<embed>要素を、内容が適切かどうかの人によるレビュー対象として報告します。
適用範囲:すでに代替テキスト(空でないaria-label、空でないテキストに解決されるaria-labelledby、または空でないtitle)を持つ<embed>要素に適用されます。存在しないidを参照するaria-labelledbyは何にも解決されないため、レビュー対象の代替テキストにはなりません。その要素はembed-text-alternative-presentの失敗です。要素はアクセシビリティツリーに含まれている必要があり、role="presentation"/"none"を指定した場合は対象外になります。ただし、フォーカス可能であればロールが復元されるため対象に含まれます。
期待される結果:提供されている代替テキストが正確かつ適切であることを、人がレビューして確認する必要があります。
検出結果が報告する内容:
reasonCode:TEXT_ALTERNATIVE_REVIEWです。ariaLabel、title:要素のaria-labelとtitleです。ない場合はnullです。ariaLabelledBy:要素のaria-labelledbyに含まれるidです。ない場合はnullです。ariaLabelledByText:それらのidが指すテキスト、またはnullです。要素にaria-labelがない場合にだけ参照します。aria-labelがあれば、それが名前になるためです。
これらのdata.detailsのフィールドは、検出結果を読み解き、再現するのに役立ちます。reasonCodeと、出力スキーマで安定と明記された一部のフィールドを除き、安定した契約ではありません。マイナーリリースで名前が変わったり、なくなったりすることがあるため、これらに依存した実装はしないでください。
例
<embed src="report.pdf" type="application/pdf" title="Quarterly report PDF">
titleがあります。埋め込みビューアーを見ることができない人にとって、それで文書を十分に識別できるか確認してください。
<embed src="report.pdf" type="application/pdf">
レビュー対象となるaria-label、解決されたaria-labelledby、titleがありません。この場合は代わりにembed-text-alternative-presentの失敗になります。
確認方法
このルールが判断できない場合はcantTellを報告し、判断を人に委ねます。ルールが投げかける各質問を、理由コードごとに、答えるための手順とともにここに示します。検出結果にも同じ手順がhowToCheckとして、スキャンの言語で含まれます。出力スキーマを参照してください。
TEXT_ALTERNATIVE_REVIEW
- レポートに示された埋め込みコンテンツが何を表示し、何をするかを確認してください。
- そのテキストによる代替(レポートに示されたaria-label、aria-labelledbyのテキスト、またはtitle)を読んでください。
- テキストが埋め込みコンテンツが何であるかを伝えているか、説明していることを確認してください。
満たす場合:テキストによる代替が、埋め込みコンテンツを正確に特定または説明しています。
満たさない場合:テキストによる代替が汎用的であるか、誤っているか、埋め込みコンテンツを説明していないため、WCAG 1.1.1を満たしません。