WWW: Improve keyboard and screen reader accessibility of project grid cards
@Okd2006 がすでに取り組んでいます。
2026年3月2日 から。
評価
- 難易度
- 3/5
- 見積もり時間
- 1〜2日
- 初心者へのやさしさ
- 55/100
- issue の種類
- 機能追加
- 明瞭さ
- おおむね明確
- 活発さ
- 停滞
- 技術スタック
- javascript
- 領域
- accessibility, frontend, web-dev
調査の方向性
aboutcode.org のホームページにあるプロジェクトグリッドから始め、プロジェクトカードの div とそのアイコンの alt 属性を調べます。各カードに Tab で到達でき、Enter または Space でアクティブ化され、プロジェクト名と button ロールとともに読み上げられ、詳細ポップアップが開くことを確認します。
索引モデルが issue の本文から書いたものです。
説明
Problem
The project cards on the homepage (aboutcode.org) cannot be reached or activated using keyboard navigation. A user who navigates via the Tab key cannot focus on any project card, and therefore has no way to open the project detail popup without a mouse.
This affects:
- Keyboard-only users (e.g., power users, users with motor impairments) who cannot access project details at all
-
- Screen reader users who are not informed that cards are interactive, since the cards lack semantic roles and labels
Current behavior
- Pressing Tab on the homepage skips over the entire project grid - cards receive no focus.
-
- Screen readers announce the cards as generic container elements with no indication that they are clickable.
-
- Every card's icon has the same alt text (
"logo"), which provides no meaningful information to assistive technology users.
- Every card's icon has the same alt text (
Expected behavior
- Users should be able to Tab through project cards and press Enter (or Space) to open the detail popup.
-
- Screen readers should announce each card as an interactive element (e.g.,
"dejacode, button") so users know it can be activated.
- Screen readers should announce each card as an interactive element (e.g.,
-
- Image alt text should be descriptive (e.g., the project name) rather than generic.
Why this matters
The project grid is the primary content of the homepage - it's how visitors discover AboutCode projects. Users who rely on keyboard navigation or assistive technology are currently locked out of this core content. Addressing this would improve the user experience for a wider audience and bring the site closer to WCAG 2.1 Level A conformance.
Suggested approach
- Add
tabIndex="0",role="button", and a keyboard event handler (onKeyDownfor Enter/Space) to each project card<div> -
- Update the card icon's
altattribute to use the project name instead of the generic"logo"
- Update the card icon's
References
- Related to the current focus on improving website content and user experience
- 主要言語
- JavaScript
- スター
- 9
- フォーク
- 17
- 平均マージ
- 7時間 55分
- マージ済み PR(30日)
- 2
環境構築
このプロジェクトには開発コンテナ、Dockerfile、コントリビューションガイドがありません。まず README を読み、一般的な手順ははじめてのコントリビューションガイドを参照してください。
はじめの一歩
- issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
- 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
- リポジトリをフォークし、ブランチを切って変更します。
- issue 番号を参照したプルリクエストを送ります。
aboutcode-org/www.aboutcode.org のほかの issue
-
Making all post button.対応中かも @sarthaklole が 70 日前に担当しました。 オープン
難易度 2/5 1〜3時間 初心者へのやさしさ 72/100
aboutcode-org/www.aboutcode.org#117 · コメント 3 件 ·
-
WWW: Reduce frequency of update-releases再び着手できるかも @johnmhoran が 50 日前に担当しましたが、オープン中のプルリクエストはありません。 オープンci-workflow
難易度 2/5 1〜3時間 初心者へのやさしさ 45/100
aboutcode-org/www.aboutcode.org#180 · 担当者 1 名 ·
-
DOCS: Create new AboutCode stack diagram(s)再び着手できるかも @hixvikas が 52 日前に担当しましたが、オープン中のプルリクエストはありません。 オープンdocumentation
難易度 5/5 1週間以上 初心者へのやさしさ 35/100
aboutcode-org/www.aboutcode.org#166 · コメント 1 件 ·
-
WWW: Create About top level page?対応中かも @pombredanne が 154 日前に担当しました。 オープンwebsite
難易度 2/5 1〜3時間 初心者へのやさしさ 35/100
aboutcode-org/www.aboutcode.org#164 · リアクション 1 件 · 担当者 1 名 ·
-
WWW: Add Initiatives and grant Projects再び着手できるかも @mjherzog が 240 日前に担当しましたが、オープン中のプルリクエストはありません。 オープンenhancement needs design website
難易度 5/5 1週間以上 初心者へのやさしさ 25/100
aboutcode-org/www.aboutcode.org#141 · 担当者 1 名 ·
aboutcode-org/www.aboutcode.org の issue をすべて見る
似ている issue
-
難易度 2/5 1〜3時間 初心者へのやさしさ 74/100
メンテナーはふだん 1 日以内に返信
-
bug documentation
難易度 1/5 1時間未満 初心者へのやさしさ 88/100
awslabs/visual-asset-management-system#880 ·
メンテナーはふだん 1 日以内に返信
-
04 type: enhancement 33 needs: docs
難易度 2/5 1〜3時間 初心者へのやさしさ 63/100
メンテナーはふだん 1 日以内に返信
-
難易度 2/5 1〜3時間 初心者へのやさしさ 74/100
メンテナーはふだん 1 日以内に返信
-
possible bug
難易度 2/5 1〜3時間 初心者へのやさしさ 85/100
Mintplex-Labs/anything-llm#6889 ·
メンテナーはふだん 1 日以内に返信