Skip to content

fix(ui5-split-button): announce accessible name before instructions - #13901

Open
Todor-ads wants to merge 3 commits into
mainfrom
split_button_annonce_order
Open

fix(ui5-split-button): announce accessible name before instructions#13901
Todor-ads wants to merge 3 commits into
mainfrom
split_button_annonce_order

Conversation

@Todor-ads

@Todor-ads Todor-ads commented Aug 10, 2026

Copy link
Copy Markdown
Contributor

Screen readers were announcing the keyboard usage instructions before the accessible name of the button, because keyboardHint was placed before accessibleName in the invisibleText span.

The fix swaps their order so the accessible name is announced immediately after the button label, followed by the instructions.

Fixes: #13841

@Todor-ads
Todor-ads requested a review from GDamyanov August 10, 2026 06:17
@Todor-ads
Todor-ads requested a review from unazko August 10, 2026 06:17
@sap-ui5-webcomponents-release

Copy link
Copy Markdown

@unazko unazko left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The custom role "Split Button" is not getting announced in JAWS. With NVDA it gets announced at the end and it should be announced after the accessible name announcement (the same as in openui5 split button).

In order to fix this custom role announcement inconsistency we should move the "Split Button" text from aria-roldescription attribute to the aria-label attribute instead (placing the custom role text directly after the accessible name).

@Todor-ads
Todor-ads deployed to netlify-preview August 13, 2026 06:22 — with GitHub Actions Active
@Todor-ads
Todor-ads requested a review from unazko August 13, 2026 12:21
return {
root: {
hasPopup: this.accessibilityAttributes?.root?.hasPopup,
roleDescription: this.accessibilityAttributes?.root?.roleDescription || (this._hideArrowButton ? undefined : SplitButton.i18nBundle.getText(SPLIT_BUTTON_DESCRIPTION)),

@unazko unazko Aug 14, 2026

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Тhe issue is already fixed, but I would also remove the aria-roledescription attribute from the SplitButtonTemplate for the group element now as aria-roledescription is not announced by JAWS. We've placed the role description text in the aria-labelledby attribute.

@Todor-ads
Todor-ads deployed to netlify-preview August 14, 2026 08:55 — with GitHub Actions Active
@Todor-ads
Todor-ads force-pushed the split_button_annonce_order branch from 9e86420 to ae867ef Compare August 14, 2026 10:53
@Todor-ads
Todor-ads deployed to netlify-preview August 14, 2026 10:53 — with GitHub Actions Active
@Todor-ads
Todor-ads requested a review from unazko August 14, 2026 10:56
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.

[ui5-split-button]: buttons announce instructions before accessible name (WCAG 2.5.3 Label in Name)

2 participants