canvas-text-alternative-quality

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

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

代替テキストが検出された<canvas>要素を、内容が同等で適切かどうかの人によるレビュー対象として報告します。

適用範囲:すでに代替テキスト(要素内のフォールバックコンテンツ、ARIAによる名前、またはtitle)を持つ<canvas>要素に適用されます。どれも持たない<canvas>には質を判断できる代替テキストがなく、それはcanvas-text-alternative-presentの失敗です。要素はアクセシビリティツリーに含まれている必要があり、role="presentation"/"none"を指定した場合は対象外になります。ただし、フォーカス可能であればロールが復元されるため対象に含まれます。

期待される結果:提供されている代替テキストが正確かつ適切であることを、人がレビューして確認する必要があります。

検出結果が報告する内容:

  • reasonCode:TEXT_ALTERNATIVE_REVIEWです。
  • value:レビュー対象のテキストによる代替です。フォールバックコンテンツ自体にテキストがなく、代替テキストを持つ画像やaria-labelを持つ要素を含む場合は、プレースホルダーのfallback-contentです。
  • mechanism:テキストによる代替がどこから来ているかを示します。canvas-fallback(<canvas>内のコンテンツ)、aria-labelledby、aria-label、titleのいずれかです。
  • flags:テキストによる代替がどのように見つかったかについての注記です。例えば、title属性だけがそれを提供している場合はtitle-usedです。

これらのdata.detailsのフィールドは、検出結果を読み解き、再現するのに役立ちます。reasonCodeと、出力スキーマで安定と明記された一部のフィールドを除き、安定した契約ではありません。マイナーリリースで名前が変わったり、なくなったりすることがあるため、これらに依存した実装はしないでください。

例

can't tell
<canvas width="400" height="200">Bar chart</canvas>

フォールバックテキスト「Bar chart」はありますが、一般的すぎます。グラフの種類だけでなく、実際のデータが伝わるかどうか確認してください。

n/a
<canvas width="400" height="200"></canvas>

レビュー対象となるフォールバックコンテンツ、ARIAによる名前、titleがありません。この場合は代わりにcanvas-text-alternative-presentの失敗になります。

確認方法

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

TEXT_ALTERNATIVE_REVIEW

  1. レポートに示されたcanvasが画面上に表示している内容を、使用中の変化も含めて確認してください。
  2. そのテキストによる代替(レポートに示された値、またはアクセシビリティペインのフォールバックコンテンツと名前)を読んでください。
  3. テキストによる代替が、グラフや図によくあるようにキャンバスの名前を示すだけの場合、詳細は別の場所(隣のキャプション、テキスト、表、またはすぐ横のリンク)にあるかもしれません。スクリーンリーダーの利用者がキャンバスからそれを見つけられ、キャンバスが示すすべてを伝えている場合にだけ、それを認めます。
  4. テキストが、そのような説明と合わせて、描画と同じ情報や目的を伝え、描画が変わると追従することを確認してください。

満たす場合:テキストによる代替が、単独で、またはスクリーンリーダーの利用者がたどれる説明と合わせて、キャンバスが示す内容と同じ情報や目的を伝えています。

満たさない場合:テキストによる代替もたどれる説明もキャンバスが示す情報を伝えていないか、テキストが曖昧または誤っているため、WCAG 1.1.1を満たしません。

関連するルール

ソースコードを見る