Announce moves to screen readers and make the board one tab stop

未关闭
#56 0 条评论 0 个 reaction 已指派 0 人 在 GitHub 查看

还没有人认领这个 Issue。

评估

难度
4/5
预计耗时
3-5 天
新手友好度
55/100
Issue 类型
功能
描述清晰度
描述清楚
活跃度
活跃
技术栈
javascript

调研方向

Read js/board.js:23-24 and js/board.js:99-136 for square creation and keyboard focus, then trace move handling in js/game.js:255-258 and the live region in index.html:25-27. Review css/board.css for animation rules and run npm test and npm run lint. Done when the board is one Tab stop, screen readers announce moves and check, and reduced motion is respected.

由索引模型根据 Issue 内容生成。

描述

enhancement help wanted severity: medium

Summary

Every square is in the tab order, so a keyboard user presses Tab 64 times to get past the board. The only live region announces whose turn it is, never the move that was played or that the king is in check.

Where

  • js/board.js:23-24 (role="gridcell", tabindex="0" on every square; no role="row" parents)
  • js/board.js:99-136 (keyboard handler and focusSquare)
  • index.html:25-27 (#game-status live region), js/game.js:255-258
  • CSS has no prefers-reduced-motion rule

Proposal

  • Roving tabindex: one square has tabindex="0", the rest -1, updated in focusSquare.
  • Wrap squares in role="row" containers.
  • Announce the move in the live region, for example "White knight to f3. Check. Black's turn", built from the existing move object.
  • Give legal targets of the selected piece a non-visual marker (label suffix or aria-describedby).
  • Add a prefers-reduced-motion rule.

Who benefits

Keyboard and screen reader users. The README lists keyboard navigation and ARIA support as features.

Acceptance criteria

  • One Tab press moves focus past the board
  • A screen reader announces each move and check
  • Animations are reduced when the user asks for reduced motion

Getting started

  • Relevant files: js/board.js, js/game.js, index.html, css/board.css
  • How to run tests: npm install, then npm test and npm run lint
  • Related docs: docs/ARCHITECTURE.md, .github/CONTRIBUTING.md

Filed by repo-audit/full-audit at 8a2c86c. Severity: medium. Effort: M. audit-key: enhancement|js/board.js|createBoard.tabindex

主要语言
JavaScript
星标
4
派生
2
PR 合并指标
30 天内没有已合并 PR

环境准备

从这里开始

  1. 先读完整个 Issue,再读项目的贡献指南。
  2. 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
  3. Fork 仓库,在一个分支上完成修改。
  4. 提交 Pull Request,并在描述里引用这个 Issue 编号。

TMHSDigital/Static_Chess 的其他 Issue

查看 TMHSDigital/Static_Chess 的全部 Issue

相似的 Issue

更多 JavaScript Issue

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。