object-text-alternative-quality

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

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

フォールバックまたは名前が検出された<object>要素を、同等性と適切さを人がレビューするために検出します。

適用範囲:すでにテキストによる代替(フォールバックのテキスト内容、空でないaria-label、空でないテキストに解決されるaria-labelledby、または空でないtitle)を持つ<object>要素に適用されます。これらのどれも持たない<object>は、品質の問題ではなくobject-text-alternative-presentのfailです。要素はアクセシビリティツリーに含まれている必要があり、role="presentation"/"none"を持つ要素は対象外です。ただし、フォーカス可能な場合はロールが復元されるため対象になります。type、それがなければdataのURLの拡張子が、HTMLページ、PDF、プレーンテキストを示すobjectは、object-text-alternative-presentと同じく対象外です。非テキストコンテンツを描画しないためです(ACT 8fc3b6)。Flashのobject(type="application/x-shockwave-flash"、またはtypeがなくdataのURLが.swfで終わるもの)も同様です。現在のブラウザーはFlashを実行しない(サポートは2021年に終了)ため、objectはそれ自体では何も描画せず、ブラウザーはフォールバックコンテンツを表示します。それはほかのルールが判定する通常のHTMLです。1.1.1の対象となる非テキストコンテンツは残りません(ACT 8fc3b6)。

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

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

  • reasonCode:TEXT_ALTERNATIVE_REVIEWです。
  • fallbackText:<object>内のテキストコンテンツで、前後の空白を除いたものです。ない場合はnullです。
  • ariaLabel:aria-labelの値です。ない場合はnullです。
  • ariaLabelledBy:aria-labelledbyの値、つまりそれが指すidです。ない場合はnullです。
  • ariaLabelledByText:aria-labelledbyが指す要素のテキストです。aria-labelがない場合にだけ参照し、それ以外の場合や何も解決されない場合はnullです。
  • title:titleの値です。ない場合はnullです。

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

例

can't tell
<object data="sales-chart.png" type="image/png">Sales chart</object>

フォールバックテキストがあります。「Sales chart」が単なる埋め草のキャプションではなく、画像と本当に同等であるかを確認する価値があります。

n/a
<object data="sales-chart.png" type="image/png"></object>

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

n/a
<object data="brochure.pdf" type="application/pdf">Product brochure (PDF)</object>

PDFが描画するのは非テキストコンテンツではなくテキストなので、1.1.1はそれに何も求めません(ACT 8fc3b6)。object-text-alternative-presentも同じ扱いです。

確認方法

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

TEXT_ALTERNATIVE_REVIEW

  1. レポートに示されたobjectを確認し、それが何を表示し、何をするか(画像、グラフ、アニメーション、プレーヤー)を控えてください。
  2. そのテキストによる代替(フォールバックテキスト、aria-label、aria-labelledbyのテキスト、またはtitle)をレポートで読むか、開発者ツールのアクセシビリティペインで読んでください。
  3. テキストによる代替が、グラフや図によくあるようにオブジェクトの名前を示すだけの場合、詳細は別の場所(隣のキャプション、テキスト、表、またはすぐ横のリンク)にあるかもしれません。スクリーンリーダーの利用者がオブジェクトからそれを見つけられ、オブジェクトが示すすべてを伝えている場合にだけ、それを認めます。
  4. 比較してください。テキストは、そのような説明と合わせて、オブジェクトが示す内容、またはコントロールやプレーヤーであれば何のためのものかを伝えていますか。

満たす場合:テキストによる代替が、単独で、またはスクリーンリーダーの利用者がたどれる説明と合わせて、オブジェクトの内容や目的を正確に説明しています。

満たさない場合:テキストによる代替が誤っているか曖昧(「オブジェクト」やファイル名など)であるか、オブジェクトが伝える内容を欠き、たどれる説明もそれを伝えていないため、WCAG 1.1.1を満たしません。

関連するルール

ソースコードを見る