Skip to content

fix(a11y): enhance toolbar toggle accessibility with aria-controls attributes - #1962

Closed
carlh7777 wants to merge 1 commit into
e35ventura:testfrom
carlh7777:fix/a11y-disclosure-aria-controls
Closed

fix(a11y): enhance toolbar toggle accessibility with aria-controls attributes#1962
carlh7777 wants to merge 1 commit into
e35ventura:testfrom
carlh7777:fix/a11y-disclosure-aria-controls

Conversation

@carlh7777

@carlh7777 carlh7777 commented Jul 1, 2026

Copy link
Copy Markdown

Summary

Add aria-controls attributes to the appearance and navigation toolbar toggle buttons, and ensure the sidebar and appearance panels have stable IDs for better screen reader support.

Why This Should Ship

This change improves accessibility for keyboard users and screen readers by clearly indicating which elements the toggle buttons control, ensuring that assistive technologies can accurately convey the state of the UI.

Review Notes

  • npm run test:mobile-header-search passes.
  • No visible UI change; behavior-only accessibility enhancement.
  • Touches [...slug].astro, WikiLayout.astro, and scripts/check-mobile-header-search.js.

Target Branch

  • This PR targets test
  • This PR targets main only because it promotes test to production

Security Checklist

  • No secrets, tokens, build hooks, wallet seeds, or private endpoints are included
  • No unnecessary workflow, dependency, or deployment changes

…tributes

## Summary

Add `aria-controls` attributes to the appearance and navigation toolbar toggle buttons, and ensure the sidebar and appearance panels have stable IDs for better screen reader support.

## Why This Should Ship

This change improves accessibility for keyboard users and screen readers by clearly indicating which elements the toggle buttons control, ensuring that assistive technologies can accurately convey the state of the UI.

## Review Notes

- `npm run test:mobile-header-search` passes.
- No visible UI change; behavior-only accessibility enhancement.
- Touches `[...slug].astro`, `WikiLayout.astro`, and `scripts/check-mobile-header-search.js`.

## Target Branch

- [x] This PR targets `test`
- [ ] This PR targets `main` only because it promotes `test` to production

## Security Checklist

- [x] No secrets, tokens, build hooks, wallet seeds, or private endpoints are included
- [x] No unnecessary workflow, dependency, or deployment changes
@carlh7777
carlh7777 requested a review from e35ventura as a code owner July 1, 2026 21:40
@taopedia-site-maintainer taopedia-site-maintainer Bot added the other Maintenance, deployment, tooling, validation, or repo work outside preferred categories label Jul 1, 2026
@taopedia-site-maintainer

Copy link
Copy Markdown

Verdict: Close

PR #1962: fix(a11y): enhance toolbar toggle accessibility with aria-controls attributes

This PR changes focus-driven on-screen behavior. Code analysis confirms the visible effect only appears during the interaction, so static before/after screenshots cannot demonstrate it (an identical-looking pair is not valid evidence). A short screen recording or GIF is required.

Visual PRs need evidence in the PR description so the maintainer can review the change quickly and reliably. A deploy preview link alone is not enough.

Required evidence for resubmission:

  • Page URL.
  • Viewport width, especially for responsive changes.
  • Action taken (the focus that reveals the change).
  • Expected before behavior.
  • Expected after behavior.
  • A short video/GIF that shows the change happening during the interaction. Static screenshots alone are not accepted for this PR.

Changed files:

  • scripts/check-mobile-header-search.js
  • src/layouts/WikiLayout.astro
  • src/pages/wiki/[...slug].astro

CI: All required CI checks passed: build

Please open a new focused PR with the required evidence attached.


Automated review by Taopedia Site Maintainer.

@carlh7777
carlh7777 deleted the fix/a11y-disclosure-aria-controls branch July 2, 2026 17:19
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

other Maintenance, deployment, tooling, validation, or repo work outside preferred categories

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant