link-name-quality

リンクテキストは汎用的な文言ではなく、内容がわかるものにすることが推奨されます

manualWCAG 2.4.4, 2.4.9 (AAA)確度:medium重大度:minoroperable

アクセシブルな名前全体が既知の内容を表さないフレーズ(例:「click here」「read more」「more」)であるリンクや、リンク先を示す隣接した文脈がない単なるファイル形式名(例:「HTML」「PDF」)のリンクを検出し、目的が明確かどうかを手動レビューに回します。英語の語句は常に認識し、ドイツ語、スペイン語、フランス語、日本語の語句は、リンクがその言語である場合に認識します。

適用範囲:a[href]、area[href]、およびrole属性がlinkに解決される要素(実在するロールの最初のトークンで、大文字と小文字は区別しません)のうち、算出されたアクセシブルな名前が空でないものです(accnameの順序に従い、aria-labelledby、aria-label、内容、最後にtitleから求めます。セレクターはlink-name-presentと同じです)。名前がまったくないリンクは、このルールではなくlink-name-presentが扱います。ElementInternalsによってlinkロールを与えられたカスタム要素(this.attachInternals().role)も、別のロールを示すrole属性がなければ、そのロールを持つネイティブ要素と同じように扱われます。

期待される結果:リンクのアクセシブルな名前全体を正規化(前後の空白を除去し、大文字と小文字を区別せず、末尾の句読点を除去)したものが、既知の内容を表さないフレーズ(「click here」「read more」「more」「here」「details」「link」など。達成基準2.4.4に対するWCAGテクニックF84の既知の失敗パターン)や、単なるファイル形式・種類の名前(「HTML」「PDF」「EPUB」など)と完全に一致しません。ただし後者が問題になるのは、リンクが何に属するかを示す隣接した文脈(aria-describedbyの参照先、リンクを含むリスト項目・表のセル・段落の、リンクの外にあるテキスト(そのインライン要素のテキストを含む)、または(形式名に限り)表の1行目の見出し)がない場合だけです。

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

  • normalizedName:照合に使った形のリンクのアクセシブルな名前で、小文字にし、空白をまとめ、末尾の句読点を取り除いたものです。汎用的な語句(GENERIC_LINK_TEXT)か、形式名だけのもの(AMBIGUOUS_FORMAT_NAME)です。

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

例

can't tell
<a href="/x">Click here</a>

「Click here」は既知の汎用的なフレーズで、文脈がなければリンク先を説明しません。

n/a
<a href="/x">Download the 2026 pricing guide</a>

リンクテキストが具体的で、内容を表しています。

確認方法

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

AMBIGUOUS_FORMAT_NAME

  1. レポートに示されたリンクを見つけてください。そのテキストは「PDF」のような形式だけです。
  2. その周囲のテキスト(文、リスト項目、表の行、またはその上の見出し)を読み、文書の名前が示されているか確認してください。
  3. リンクをたどり、その文脈が示す文書であることを確認してください。

満たす場合:周囲の文、リスト項目、行、または見出しが文書の名前を示しているため、リンクはたとえば「年次報告書のPDF」として伝わります。

満たさない場合:リンクの近くにどの文書かを伝えるものがなく、リンク先が不明確なため、WCAG 2.4.4を満たしません。リンクテキストだけでは不明確な場合は、2.4.9を満たしません。

  1. レポートに示されたリンクを見つけ、「続きを読む」や「ここをクリック」などのテキストを読んでください。
  2. リンクを使う人と同じように、そのすぐ周りにある文、リスト項目、表のセル、または見出しを読んでください。
  3. リンクテキストとその文脈を合わせてリンク先が明確になるかを検討し、次にリンクの一覧(リンクテキストだけ)で明確になるかを確認してください。
  4. リンクをたどり、文脈が示すとおりの場所に移動することを確認してください。

満たす場合:リンクテキストと周囲の文、リスト項目、セル、または見出しによってリンク先が明確です。AAAでは、リンクテキストだけで明確です。

満たさない場合:リンクテキストも周囲の文脈もリンク先を伝えていないため、WCAG 2.4.4を満たしません(F84)。リンクテキストだけでは不明確な場合は、2.4.9を満たしません。

関連するルール

ソースコードを見る