Skip to content

fix(a11y): label cluster markers and announce zoom-guard to screen readers - #132

Merged
yakew7 merged 1 commit into
StudentSuite:mainfrom
aryansk:fix/a11y-map-clusters-zoom-guard
Aug 14, 2026
Merged

fix(a11y): label cluster markers and announce zoom-guard to screen readers#132
yakew7 merged 1 commit into
StudentSuite:mainfrom
aryansk:fix/a11y-map-clusters-zoom-guard

Conversation

@aryansk

@aryansk aryansk commented Aug 14, 2026

Copy link
Copy Markdown
Contributor

Closes #99

Two of the three gaps from the issue:

Cluster markers (map-view.tsx) are divIcons with no accessible name. Each cluster now gets:

  • role="button" + tabindex="0" so it's focusable,
  • an aria-label summarizing its contents (e.g. "Cluster of 11 places, mostly SAT centre"),
  • Enter/Space keyboard activation that performs the same zoom-in as click.

ScrollZoomGuard hint is aria-hidden and mouse-wheel-only. Added an sr-only note announcing the keyboard zoom alternative (+/- keys or Ctrl/Cmd + scroll).

The third item (desktop zoom-hint dismiss button with a literal "x") no longer exists: the zoom-hint workaround was removed in a06bedd ("fix(map): resolve sidebar density issue, remove zoom hint workaround"), so nothing to change there.

Validation: tsc --noEmit clean, npm run lint clean, npm run test:unit 38/38, npm run build succeeds.

…aders

Cluster markers are divIcons with no accessible name, so a screen-reader
user hears an unlabeled button with no hint of what it represents. Give
each cluster a role=button, tabindex=0, and an aria-label summarizing its
contents ("Cluster of 11 places, mostly SAT centre"), and make Enter/Space
trigger the same zoom-in that click does.

ScrollZoomGuard's hint is aria-hidden and only fires on mouse wheel, so
keyboard users get no equivalent messaging. Add an sr-only note that
announces the keyboard zoom alternative (+/- keys or Ctrl/Cmd + scroll).

Closes StudentSuite#99
@vercel

vercel Bot commented Aug 14, 2026

Copy link
Copy Markdown
Contributor

@AryanSingh is attempting to deploy a commit to the studentsuite Team on Vercel.

A member of the Team first needs to authorize it.

@yakew7
yakew7 marked this pull request as ready for review August 14, 2026 07:25
@yakew7
yakew7 merged commit 9c8d0f9 into StudentSuite:main Aug 14, 2026
3 of 4 checks passed
@aryansk

aryansk commented Aug 14, 2026

Copy link
Copy Markdown
Contributor Author

Noted. The deploy authorization for the studentsuite team is a team-member action that cannot be performed from the fork; this PR has since merged (commit 9c8d0f9). Recording the state here — no further contributor-side action is available.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

a11y: cluster markers unlabeled for screen readers, scroll-zoom guard has no keyboard equivalent

3 participants