WWW: Improve keyboard and screen reader accessibility of project grid cards
@Okd2006 arbeitet bereits daran.
Seit 02.3.2026.
Bewertung
- Schwierigkeit
- 3/5
- Geschätzter Aufwand
- 1-2 Tage
- Anfängerfreundlichkeit
- 55/100
- Issue-Typ
- Feature
- Klarheit
- Größtenteils klar
- Aktivitätsstatus
- Veraltet
- Tech-Stack
- javascript
- Bereich
- accessibility, frontend, web-dev
Rechercherichtung
Beginnen Sie beim Projekt-Grid auf der Startseite von aboutcode.org und untersuchen Sie das Projektkarten-div sowie dessen alt-Attribut für das Icon. Überprüfen Sie, dass jede Karte mit Tab erreichbar ist, mit Enter oder Space aktiviert wird, mit ihrem Projektnamen und der button-Rolle angesagt wird und das Detail-Popup öffnet.
Vom Indexierungsmodell aus dem Issue-Text verfasst.
Beschreibung
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
- Vorherrschende Sprache
- JavaScript
- Sterne
- 9
- Forks
- 17
- Ø Merge
- 7 Std. 55 Min.
- Gemergte PRs (30 T.)
- 2
Entwicklungsumgebung
Dieses Projekt bietet weder Dev-Container noch Dockerfile noch Beitragsleitfaden – die Einrichtung liegt bei Ihnen. Beginnen Sie mit der README; die allgemeinen Schritte stehen in unserem Leitfaden für den ersten Beitrag.
Erste Schritte
- Lesen Sie das ganze Issue und danach den Beitragsleitfaden des Projekts.
- Schreiben Sie ins Issue, dass Sie es übernehmen — das erspart doppelte Arbeit.
- Forken Sie das Repository und arbeiten Sie in einem Branch.
- Öffnen Sie einen Pull Request, der die Issue-Nummer nennt.
Mehr aus aboutcode-org/www.aboutcode.org
-
Making all post button.Evtl. vergeben @sarthaklole hat das vor 71 Tagen übernommen. Offen
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 72/100
aboutcode-org/www.aboutcode.org#117 · 3 Kommentare ·
-
WWW: Reduce frequency of update-releasesEvtl. wieder frei @johnmhoran hat das vor 51 Tagen übernommen, und es ist kein Pull Request offen. Offenci-workflow
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 45/100
aboutcode-org/www.aboutcode.org#180 · 1 zugewiesene Person ·
-
DOCS: Create new AboutCode stack diagram(s)Evtl. wieder frei @hixvikas hat das vor 53 Tagen übernommen, und es ist kein Pull Request offen. Offendocumentation
Schwierigkeit 5/5 Über eine Woche Anfängerfreundlichkeit 35/100
aboutcode-org/www.aboutcode.org#166 · 1 Kommentar ·
-
WWW: Create About top level page?Evtl. vergeben @pombredanne hat das vor 154 Tagen übernommen. Offenwebsite
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 35/100
aboutcode-org/www.aboutcode.org#164 · 1 Reaktion · 1 zugewiesene Person ·
-
WWW: Add Initiatives and grant ProjectsEvtl. wieder frei @mjherzog hat das vor 241 Tagen übernommen, und es ist kein Pull Request offen. Offenenhancement needs design website
Schwierigkeit 5/5 Über eine Woche Anfängerfreundlichkeit 25/100
aboutcode-org/www.aboutcode.org#141 · 1 zugewiesene Person ·
Alle Issues in aboutcode-org/www.aboutcode.org
Ähnliche Issues
-
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 85/100
Maintainer antworten meist innerhalb von 1 Tag
-
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 73/100
microsoft/monaco-editor#5563 ·
Maintainer antworten meist innerhalb von 1 Tag
-
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 85/100
Maintainer antworten meist innerhalb von 1 Tag
-
account: profile bug
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 78/100
Maintainer antworten meist innerhalb von 5 Tagen
-
ai-driven-fuzzing bug claude Minor
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 78/100
linagora/cozy-client#1777 · 1 Kommentar · 1 Reaktion ·
Maintainer antworten meist innerhalb von 1 Tag