Accessibility: keyboard move entry and screen reader support (#72) (#115)

* commented out lesson and learning strip until lessons are established

* reword the hero section

* change layout and working on puzzle section - remove top div as it was
redundant

* amend flash message on replay

* switch cancel session for return home

* remove system theme toggle since this is the default, leaving only light
and dark toggles

* add keyboard and screen reader support for play (#72)

First draft covering the accessibility work in #72:\n\n- labelled SAN/UCI move input, validated against the tablebase and applied\n  by the board hook, plus an accessible promotion picker\n- live-region announcements for moves, checks, checkmates and solve/fail,\n  and a hidden text summary of the position\n- accessible labels, focus ring, skip link, keyboard-friendly review table\n  and non-colour grade cues\n- WCAG AA text contrast roles and a responsive play surface\n- regression tests for move entry, announcements and link-style CTAs
This commit is contained in:
2026-11-09 12:09:07 +01:00
committed by GitHub
parent 8df7ac982c
commit 805c2f1150
31 changed files with 812 additions and 136 deletions
@@ -25,6 +25,14 @@ defmodule ChesstrainerWeb.LandingComponentsTest do
assert html =~ "Today’s position"
end
test "describes the board as an image for assistive technology" do
html = render_component(&LandingComponents.board_preview/1, %{endgame: @endgame})
assert html =~ ~s(role="img")
assert html =~ "Chess position. White to move"
assert html =~ "rook on f3"
end
test "falls back to a neutral position without an endgame" do
html = render_component(&LandingComponents.board_preview/1, %{endgame: nil})
@@ -31,14 +31,13 @@ defmodule ChesstrainerWeb.LayoutsTest do
end
describe "colour_mode_toggle/1" do
test "renders all three modes as a labelled radiogroup" do
test "renders light and dark modes as a labelled radiogroup" do
html = render_component(&Layouts.colour_mode_toggle/1, %{})
assert html =~ ~s(role="radiogroup")
assert html =~ ~s(aria-label="Colour mode")
for {mode, label} <- [
{"system", "System colour mode"},
{"light", "Light colour mode"},
{"dark", "Dark colour mode"}
] do
@@ -47,6 +46,7 @@ defmodule ChesstrainerWeb.LayoutsTest do
assert html =~ ~s(role="radio")
end
refute html =~ ~s(data-phx-theme="system")
assert html =~ ~s(aria-checked="true")
end
@@ -57,4 +57,13 @@ defmodule ChesstrainerWeb.LayoutsTest do
assert html =~ ~s(class="nav-right")
end
end
describe "pill button" do
test "renders the navigation call to action as a link" do
html = render_component(&Layouts.navbar/1, %{current_scope: nil})
assert html =~ ~r/<a[^>]*class="nav-cta"/
refute html =~ ~r/<button[^>]*class="nav-cta"/
end
end
end
@@ -0,0 +1,27 @@
defmodule ChesstrainerWeb.Board.PositionTextTest do
use ExUnit.Case, async: true
alias ChesstrainerWeb.Board.PositionText
test "names the side to move and every piece" do
assert PositionText.summary("8/8/3k4/8/8/3K1R2/8/8 w - - 0 1") ==
"White to move. White: king on d3, rook on f3. Black: king on d6."
end
test "describes black to move" do
assert PositionText.summary("8/8/3k4/8/8/3K1R2/8/8 b - - 0 1") =~
"Black to move."
end
test "includes pawns and both colours" do
summary = PositionText.summary("8/8/3k4/8/8/3K1R2/4P3/8 w - - 0 1")
assert summary =~ "White: king on d3, rook on f3, pawn on e2."
assert summary =~ "Black: king on d6."
end
test "falls back when the FEN cannot be read" do
assert PositionText.summary("not a fen") == "Chess position."
assert PositionText.summary(nil) == "Chess position."
end
end