Skip to content

List - examples should use unique aria labeling #11396

Description

@thatblindgeye

Describe the enhancement or change
The lists in examples should have unique aria labeling to follow the recommendation of doing so when multiple are on a page. For nested lists, the label could be the text of its parent item, but would require tweaking the list item content in examples to include the example name, e.g. "Basic first item" instead of "First".

Components with lists that should be updated are below, and should include their own examples/demos as well as anywhere else they're being used (e.g. Breadcrumbs being used in our Dashboard demo components). We're ignoring issues that would need to be fixed in Org, <ul> or <ol> elements with a role other than list (like TreeView), as well as Markdown lists; the Markdown lists would need discussion for updating them or not and how to go about it best.

  • AlertGroup
  • Breadcrumb
  • Divider ("Using li" example)
  • JumpLinks (component code may also need tweaking; we export a JumpLinksList component, but JumpLinks isn't using it and doesn't allow passing any other props to the ul)
  • LabelGroup (specific callout for the Toolbar examples "With filters" and "With custom label group content" are using the same labeling for labelgroups and need to be unique)
  • List
  • LoginPage (the footer list of links in demos could use their own unique labling
  • Multiple file upload (the "Rejected" demo's status list after something is uploaded)
  • Navigation (similar to JumpLinks; we export a NavList but NavExpandable and NavGroup aren't using it+don't have a way to pass an aria-label in to label the NavList)
  • NotificationDrawer (full page demos)
  • ProgressStepper ("Compact" example and "Basic" demo)
  • Skip to content basic demo is using several u/ol's
  • Toolbar (the "Sticky" example using a plain ul element)
  • Wizard (the WizardNav component)

Is this request originating from a Red Hat product team? If so, which ones and is there any sort of deadline for this enhancement?

Any other information?

Activity

  1. moved this from Needs triage to Needs info in PatternFly Issueson Feb 20, 2025
  2. github-actions commented on Mar 11, 2025

    @github-actions

    This issue has been automatically marked as stale because it has not had recent activity. It will be closed if no further activity occurs.

  3. changed the issue type fromtoon Mar 27, 2025
  4. moved this from Needs info to Ready to assign in PatternFly Issueson Mar 27, 2025
  5. moved this from Ready to assign to Backlog in PatternFly Issueson Apr 9, 2025
  6. github-actions commented on May 29, 2025

    @github-actions

    This issue has been automatically marked as stale because it has not had recent activity. It will be closed if no further activity occurs.

  7. github-actions commented on Jul 30, 2025

    @github-actions

    This issue has been automatically marked as stale because it has not had recent activity. It will be closed if no further activity occurs.

  8. github-actions commented on Nov 26, 2025

    @github-actions

    This issue has been automatically marked as stale because it has not had recent activity. It will be closed if no further activity occurs.

  9. thatblindgeye commented on Nov 26, 2025

    @thatblindgeye
    ContributorAuthor

    After discussion with another a11y expert, going to close this out in favor of us easing up on labeling lists and do it on a more case-by-case basis

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Type

    Projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions