Skip to content

feat(ui5-dynamic-side-content): add 'role' property to accessibilityAttributes object#13476

Open
NHristov-sap wants to merge 8 commits into
mainfrom
BL_dsc_role
Open

feat(ui5-dynamic-side-content): add 'role' property to accessibilityAttributes object#13476
NHristov-sap wants to merge 8 commits into
mainfrom
BL_dsc_role

Conversation

@NHristov-sap
Copy link
Copy Markdown
Contributor

@NHristov-sap NHristov-sap commented May 7, 2026

Until now, there were hardcoded roles for main (role="main") and side (role="complementary") containers of the ui5-dynamic-side-content component. In general case that is fine, but there are use cases where the component is placed in another landscape component that already has role="main" attribute, which produces Accessibility issues.

This PR introduces new property role in the accessibilityAttributes object of the component both for main and side containers. Now the developer has three options for role:

  • if role property is not defined, the role attributes of main or side content container keeps the existing values ("main" for main content and "complementary" for side content;
  • if role property is set to some string value, it is populated in corresponding role attribute ot main or side content;
  • if role property is set to undefined, the role attribute is completely removed.

@NHristov-sap NHristov-sap changed the title feat(ui5-dynamic-side-content): add 'role' property in accessibilityAttributes feat(ui5-dynamic-side-content): add 'role' property to accessibilityAttributes object May 7, 2026
@ui5-webcomponents-bot
Copy link
Copy Markdown
Collaborator

ui5-webcomponents-bot commented May 7, 2026

@ui5-webcomponents-bot ui5-webcomponents-bot temporarily deployed to preview May 7, 2026 13:27 Inactive
@ui5-webcomponents-bot ui5-webcomponents-bot temporarily deployed to preview May 7, 2026 13:53 Inactive
@ui5-webcomponents-bot ui5-webcomponents-bot temporarily deployed to preview May 18, 2026 10:33 Inactive
@NHristov-sap NHristov-sap requested review from GDamyanov and unazko May 18, 2026 10:42
@NHristov-sap NHristov-sap marked this pull request as ready for review May 18, 2026 10:43
@ui5-webcomponents-bot ui5-webcomponents-bot temporarily deployed to preview May 18, 2026 10:54 Inactive
@ui5-webcomponents-bot ui5-webcomponents-bot temporarily deployed to preview May 18, 2026 11:22 Inactive
Comment thread packages/fiori/src/DynamicSideContent.ts
*
* - **sideContent**:
* `sideContent.ariaLabel` defines the aria-label of the side content area. Accepts any string.
* `sideContent.role` defines the role of the side content area. When not set, defaults to `"complementary"`. Set to `undefined` to remove the role attribute.
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.

Can we adjust the indentation of the added properties

@ui5-webcomponents-bot ui5-webcomponents-bot temporarily deployed to preview May 18, 2026 13:27 Inactive
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.

3 participants