From e8789a8857af69f3d151570cb4a5ffc184e6d85e Mon Sep 17 00:00:00 2001 From: "google-labs-jules[bot]" <161369871+google-labs-jules[bot]@users.noreply.github.com> Date: Wed, 8 Jul 2026 13:20:44 +0000 Subject: [PATCH] =?UTF-8?q?=F0=9F=8E=A8=20Palette:=20Improve=20game=20acce?= =?UTF-8?q?ssibility=20and=20add=20keyboard=20instructions?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Added visible text instructions for game controls (Space/Up Arrow) to improve usability. - Extracted static "Score: " text from the `aria-live` region in the HTML and JS logic. This prevents screen readers from pointlessly repeating the static text on every score update, significantly reducing auditory clutter. Co-authored-by: EiJackGH <172181576+EiJackGH@users.noreply.github.com> --- .Jules/palette.md | 4 ++++ src/views/mario-game.njk | 16 +++++++++++++--- 2 files changed, 17 insertions(+), 3 deletions(-) diff --git a/.Jules/palette.md b/.Jules/palette.md index 8ee612f..47ad1a8 100644 --- a/.Jules/palette.md +++ b/.Jules/palette.md @@ -12,3 +12,7 @@ ## 2025-03-23 - Game Key Scrolling **Learning:** Browsers natively scroll the page when users press Space or Arrow keys. When building a web-based game, this creates a frustrating UX where the game viewport jumps around while playing. **Action:** Always call `e.preventDefault()` on keydown events for typical game controls ("Space", "ArrowUp", etc.) when the focus is on a game container or the body. + +## 2025-03-24 - Screen Reader Game Feedback +**Learning:** Static instructions inside `aria-live` regions force screen readers to unnecessarily repeat the static text every time the dynamic content updates. +**Action:** Extract static text into a separate sibling element or parent container and only apply `aria-live` to the specific node that dynamically updates. Always ensure visible keyboard instructions are provided for custom HTML5 game interfaces. diff --git a/src/views/mario-game.njk b/src/views/mario-game.njk index 67b6bd7..b7f11a9 100644 --- a/src/views/mario-game.njk +++ b/src/views/mario-game.njk @@ -44,7 +44,7 @@ background: #2ecc71; } - #score { + #score-container { position: absolute; top: 10px; left: 10px; @@ -52,13 +52,23 @@ font-size: 20px; font-family: Arial; } + + #instructions { + position: absolute; + top: 10px; + right: 10px; + color: white; + font-size: 20px; + font-family: Arial; + }
-
Score: 0
+
Score: 0
+
Press Space or Up Arrow to jump
@@ -118,7 +128,7 @@ clearInterval(move); goomba.remove(); score++; - scoreText.innerText = "Score: " + score; + scoreText.innerText = score; } else { position -= 6; goomba.style.left = position + "px";