Hacktoberfest 2026:メンテナが10月に向けて印を付けた、オープンで初心者向けの issue。 Hacktoberfest の issue を見る

Audit accessibility against WCAG 2.1 AA with VoiceOver and TalkBack

オープン
#25 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る

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

評価

難易度
4/5
見積もり時間
3〜5日
初心者へのやさしさ
35/100
issue の種類
機能追加
明瞭さ
明確に書かれている
活発さ
活発
技術スタック
android, ios, playwright, typescript

調査の方向性

Start with the referenced transcript and sheet components, style tokens, style tests, Playwright test, and ADR 0009; review the existing accessibility behavior and test setup. Run the Playwright suite, then audit the listed screens in all three themes and manually play the demo pack with VoiceOver, TalkBack, and desktop keyboard navigation. Done means the acceptance criteria pass, findings are filed separately, blocking issues are fixed, and the accessibility statement is linked from About.

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

説明

area: web help wanted priority: high type: feature

Context

Text adventures suit blind and low-vision players well, and the player is plain DOM with no component library (ADR 0009 accepts the extra manual work for focus management and accessibility). The transcript is a role="log" live region and text contrast is unit-tested, but no audit has been done. The v0.1 screens were probed at 390 and 320 CSS px without horizontal overflow; one toolbar label is cut off at 320 px (#49).

Scope

  • Automated checks: axe-core in the Playwright tests for library, game, action sheet, hint, settings, create and about screens, in all three themes (dev dependency only).
  • Manual tests: VoiceOver on iOS Safari (installed to the home screen), TalkBack on Android Chrome, and keyboard only on desktop, each playing the demo pack to the end.
  • Focus areas: new output announced once without re-reading the transcript; focus moves into sheets and dialogs and back; accessible names and roles for references, chips and toolbar buttons; contrast of UI components and focus indicators; text resize to 200 percent; reflow at 320 CSS px; focus order; status messages (toasts, score, new clues).
  • File findings as separate type: bug issues; fix the blocking ones in this milestone.
  • An accessibility statement with known limitations in docs/.

Acceptance criteria

  • axe-core reports no serious or critical violations on any screen in any theme.
  • The demo pack is completed with VoiceOver and with TalkBack; session notes are attached to this issue.
  • UI components and focus indicators reach at least 3:1 contrast in light, sepia and dark (added to apps/web/test/styles.test.ts).
  • New story output is announced once per command.
  • The accessibility statement is published and linked from the about screen.

References

  • apps/web/src/components/transcript.ts
  • apps/web/src/components/sheet.ts
  • apps/web/src/styles/tokens.css
  • apps/web/test/styles.test.ts
  • apps/web/e2e/play.spec.ts
  • docs/adr/0009-vanilla-typescript-ui.md
主要言語
TypeScript
スター
0
フォーク
0
平均マージ
28分
マージ済み PR(30日)
2

環境構築

はじめの一歩

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

nullthrone/lexvm のほかの issue

nullthrone/lexvm の issue をすべて見る

似ている issue

TypeScript の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。