Skip to content

fix: Block-level ARIA labels no longer include clickable image descri…#9844

Merged
lizschwab merged 3 commits into
RaspberryPiFoundation:v13from
lizschwab:rpf-9797
May 12, 2026
Merged

fix: Block-level ARIA labels no longer include clickable image descri…#9844
lizschwab merged 3 commits into
RaspberryPiFoundation:v13from
lizschwab:rpf-9797

Conversation

@lizschwab
Copy link
Copy Markdown
Contributor

@lizschwab lizschwab commented May 7, 2026

The basics

The details

Resolves

Fixes #9797

Proposed Changes

Updates how we handle ARIA labels for clickable images (image buttons) as folows:

  • At the block level, we ignore these images
  • At the focusable element level, we set the ARIA label to the alt text

Before changes

Block level:
Screenshot 2026-05-12 at 1 17 39 PM (2)
Clickable image level:
Screenshot 2026-05-12 at 1 17 49 PM (2)

After changes

Block level:
Screenshot 2026-05-12 at 1 18 33 PM (2)
Clickable image level:
Screenshot 2026-05-12 at 1 18 42 PM (2)

Reason for Changes

The way we were handling image buttons was confusing to users and made it difficult to navigate custom blocks with image buttons.

Test Coverage

Updated an existing test and added a new test.

@github-actions github-actions Bot added the PR: fix Fixes a bug label May 7, 2026
@github-actions github-actions Bot added PR: fix Fixes a bug and removed PR: fix Fixes a bug labels May 12, 2026
@lizschwab lizschwab marked this pull request as ready for review May 12, 2026 20:30
@lizschwab lizschwab requested a review from a team as a code owner May 12, 2026 20:30
@lizschwab lizschwab requested a review from gonfunko May 12, 2026 20:30
@lizschwab lizschwab merged commit e32ef65 into RaspberryPiFoundation:v13 May 12, 2026
8 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

PR: fix Fixes a bug

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants