Skip to content

fix(web-components): #4451 preserve dialog content semantics - #4625

Open
sylvesterkaczmarek wants to merge 1 commit into
mi6:developfrom
sylvesterkaczmarek:fix/4451-dialog-aria-description
Open

fix(web-components): #4451 preserve dialog content semantics#4625
sylvesterkaczmarek wants to merge 1 commit into
mi6:developfrom
sylvesterkaczmarek:fix/4451-dialog-aria-description

Conversation

@sylvesterkaczmarek

Copy link
Copy Markdown

Summary of the changes

Remove the forced aria-describedby from IcDialog's native dialog element so structured slotted content is not flattened into a single screen-reader description.

This keeps aria-labelledby for the dialog heading/label and allows links and other semantic content to remain navigable.

Added:

  • unit regression coverage with structured dialog content and a link
  • React/Cypress accessibility coverage confirming aria-describedby is omitted, heading labelling is preserved, the slotted link remains focusable, and axe passes

This follows WAI-ARIA APG guidance to omit aria-describedby when dialog content contains semantic structures that need to be navigated.

Related issue

Closes #4451

Comment thread packages/react/src/component-tests/IcDialog/IcDialogAriaDescription.cy.tsx Outdated

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.

Looks like this file has a prettier error, please can you run npm run prettier:fix to fix it?

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

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

Fixed. Reformatted the Cypress changes and rebuilt the branch cleanly on current develop.

Comment thread packages/react/src/component-tests/IcDialog/IcDialog.cy.tsx
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.

2 participants