Skip to content

content: using "aria-labelledby", as suggested by the Accessibility Guidelines, never worked with modals #3809

Open

Description

@KernelLeak

URL

https://ionic.io/docs/accessibility/ion-modal

Issue Description

In the Accessibility Guidelines for modals, it says:

In the above example the logical choice for an accessible name would be the ion-title of "Welcome". We can associate the modal with this by setting the aria-labelled attribute and giving the ion-title an id:

Leaving aside that it should be aria-labelledby, this has never worked as the only two attributes that are pushed down to the actual div that also gets assigned the role attribute of "dialog" are role and aria-label, as seen here in the code for modal.

So either the code needs a fix to support aria-labelledby, or the docs need to be adjusted.

Activity

  1. added
    contentIssues related to the contents of the documentation website
    on Jul 19, 2025
  2. added
    contentIssues related to the contents of the documentation website
    and removed
    contentIssues related to the contents of the documentation website
    on Jul 19, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    contentIssues related to the contents of the documentation website

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions