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
@@ -67,6 +67,12 @@
<Layouts.theme_script />
</head>
<body>
<a
href="#main-content"
class="sr-only focus:not-sr-only focus:fixed focus:left-4 focus:top-4 focus:z-50 focus:rounded-md focus:bg-base-100 focus:px-4 focus:py-2 focus:text-base-content focus:shadow-lg"
>
Skip to main content
</a>
<Layouts.navbar current_scope={@current_scope} />
{@inner_content}
<Layouts.footer />
@@ -16,14 +16,15 @@
}
};
const selectedMode = () => {
const source = document.documentElement.getAttribute("data-theme-source");
return source === "system" ? "system" : document.documentElement.getAttribute("data-theme");
};
// There is no system button, so report the effective theme. This keeps the
// visible light/dark control in sync when the page is following the OS.
const selectedMode = () => document.documentElement.getAttribute("data-theme");
const syncChecked = () => {
document.querySelectorAll("[data-phx-theme]").forEach((button) => {
button.setAttribute("aria-checked", String(button.dataset.phxTheme === selectedMode()));
const checked = button.dataset.phxTheme === selectedMode();
button.setAttribute("aria-checked", String(checked));
button.tabIndex = checked ? 0 : -1;
});
};
@@ -56,6 +57,25 @@
if (button) setMode(button.dataset.phxTheme);
});
// Arrow keys move between the radio options, as a radiogroup should.
document.addEventListener("keydown", (event) => {
const button = event.target instanceof Element && event.target.closest("[data-phx-theme]");
if (!button) return;
if (event.key !== "ArrowLeft" && event.key !== "ArrowRight") return;
event.preventDefault();
const buttons = Array.from(document.querySelectorAll("[data-phx-theme]"));
const offset = event.key === "ArrowRight" ? 1 : -1;
const index = (buttons.indexOf(button) + offset + buttons.length) % buttons.length;
const next = buttons[index];
if (next) {
setMode(next.dataset.phxTheme);
next.focus();
}
});
window.addEventListener("storage", (event) => {
if (event.key === "phx:theme") setMode(event.newValue || "system");
});