Skip to content

feat: Add basic support for generating ARIA labels and roles for blocks#9696

Merged
gonfunko merged 12 commits intov13from
puccini
Apr 15, 2026
Merged

feat: Add basic support for generating ARIA labels and roles for blocks#9696
gonfunko merged 12 commits intov13from
puccini

Conversation

@gonfunko
Copy link
Copy Markdown
Contributor

The basics

The details

Resolves

Fixes #9685

Proposed Changes

This PR adds basic support for adding ARIA roles and labels to blocks. It backports the existing behavior from the screenreader branch, with heavy refactoring to improve readability and maintainability.

Future Work

Labeling will be substantially improved by field subclasses customizing their labeling. Those changes will be automatically incorporated; this PR uses the newly-introduced APIs to get appropriate field labels.

Additionally, label generation should be tweaked once Inputs have support for overriding labeling to use those APIs.

When support for detailed readout keyboard shortcuts and "where am I" shortcuts are added, methods to compute labels for the full tree leading up to a block (specified in the design doc) should be added.

@gonfunko gonfunko requested a review from a team as a code owner April 10, 2026 15:44
@gonfunko gonfunko requested a review from maribethb April 10, 2026 15:44
@github-actions github-actions bot added the PR: feature Adds a feature label Apr 10, 2026
Comment thread packages/blockly/core/utils/aria.ts
Comment thread packages/blockly/core/block_aria_composer.ts Outdated
Comment thread packages/blockly/core/utils/aria.ts Outdated
Comment thread packages/blockly/core/block_aria_composer.ts Outdated
Comment thread packages/blockly/core/block_aria_composer.ts Outdated
Comment thread packages/blockly/msg/messages.js Outdated
Comment thread packages/blockly/core/block_svg.ts
@gonfunko gonfunko requested a review from maribethb April 14, 2026 16:43
Comment thread packages/blockly/core/block_svg.ts Outdated
@gonfunko gonfunko merged commit 91d02ee into v13 Apr 15, 2026
4 checks passed
@gonfunko gonfunko deleted the puccini branch April 15, 2026 15:12
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

PR: feature Adds a feature

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants