embed-text-alternative-quality

<embed>の代替テキストは適切である必要があります(手動レビュー)

manualWCAG 1.1.1 (A)確度:medium重大度:minorperceivable

名前が検出された<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と、出力スキーマで安定と明記された一部のフィールドを除き、安定した契約ではありません。マイナーリリースで名前が変わったり、なくなったりすることがあるため、これらに依存した実装はしないでください。

例

can't tell
<embed src="report.pdf" type="application/pdf" title="Quarterly report PDF">

titleがあります。埋め込みビューアーを見ることができない人にとって、それで文書を十分に識別できるか確認してください。

n/a
<embed src="report.pdf" type="application/pdf">

レビュー対象となるaria-label、解決されたaria-labelledby、titleがありません。この場合は代わりにembed-text-alternative-presentの失敗になります。

確認方法

このルールが判断できない場合はcantTellを報告し、判断を人に委ねます。ルールが投げかける各質問を、理由コードごとに、答えるための手順とともにここに示します。検出結果にも同じ手順がhowToCheckとして、スキャンの言語で含まれます。出力スキーマを参照してください。

TEXT_ALTERNATIVE_REVIEW

  1. レポートに示された埋め込みコンテンツが何を表示し、何をするかを確認してください。
  2. そのテキストによる代替(レポートに示されたaria-label、aria-labelledbyのテキスト、またはtitle)を読んでください。
  3. テキストが埋め込みコンテンツが何であるかを伝えているか、説明していることを確認してください。

満たす場合:テキストによる代替が、埋め込みコンテンツを正確に特定または説明しています。

満たさない場合:テキストによる代替が汎用的であるか、誤っているか、埋め込みコンテンツを説明していないため、WCAG 1.1.1を満たしません。

関連するルール

ソースコードを見る