Accessibility: 9 links without accessible text on react.dev (WCAG 2.4.4)

オープン

#8,366 2026年3月18日に作成コメント 1 件リアクション 0 件担当者 0 名 GitHub で見る

まだ誰も着手していません。

主要言語: JavaScript
スター: 11.8k
フォーク: 7.9k
平均マージ: 1日 11時間
マージ済み PR（30日）: 11

説明

Summary

An automated WCAG accessibility scan of react.dev found 3 issues affecting ADA compliance:

Score: 20/100 (Grade F) — CRITICAL risk tier

Issues Found

#	Severity	Issue	WCAG
1	CRITICAL	9 links without accessible text	2.4.4 Link Purpose (Level A)
2	SERIOUS	Missing skip navigation link	2.4.1 Bypass Blocks (Level A)
3	MODERATE	Heading hierarchy skips (h2 → h4)	1.3.1 Info and Relationships (Level A)

Suggested Fixes

1. Links without accessible text (CRITICAL)

9 links have no visible text, aria-label, or image alt text. Screen readers announce these as "link" with no purpose.

<!-- Before -->
<a href="/learn"><svg>...</svg></a>

<!-- After -->
<a href="/learn" aria-label="Learn React"><svg>...</svg></a>

2. Missing skip navigation (SERIOUS)

No skip-to-content link found. Keyboard-only users must tab through the entire sidebar and nav on every page load.

<body>
  <a href="#main" class="sr-only focus:not-sr-only focus:absolute focus:z-50 focus:p-4">
    Skip to main content
  </a>
  ...
  <main id="main">...</main>
</body>

3. Heading hierarchy (MODERATE)

Heading levels skip from h2 to h4, which confuses screen reader users navigating by heading.

Why This Matters

React is used by millions of developers who look to react.dev as an example
WCAG 2.4.4 (Link Purpose) is among the most cited ADA violations
Leading by example on accessibility helps the entire React ecosystem

Reproduction

npx accessscore https://react.dev

Scanned with AccessScore — open source WCAG/ADA checker.

コントリビューションガイド

コントリビューションガイドを開く

はじめの一歩

issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
リポジトリをフォークし、ブランチを切って変更します。
issue 番号を参照したプルリクエストを送ります。

調査の方向性

まず、報告された npx accessscore https://react.dev スキャンを実行し、そのスキャンで特定された react.dev のナビゲーション、リンク、見出し構造を確認します。テキストのないリンク9件に対応し、スキップナビゲーションを追加し、報告された見出し階層を修正します。スキャンで検出された問題が解決され、サイトが引き続きキーボードとスクリーンリーダーで操作できれば完了です。

索引モデルが issue の本文から書いたものです。

評価

技術スタック: javascript, react
領域: accessibility, web-dev
issue の種類: バグ
難易度: 4/5
見積もり時間: 3〜5日
活発さ: 静か
明瞭さ: おおむね明確
初心者へのやさしさ: 48/100