Skip to content

[tree view] checkbox indeterminate state missing aria-checked="mixed" for accessibility #18740

Open
mui/material-ui
#46497
@yhy-1

Description

@yhy-1

Steps to reproduce

Steps to reproduce

  1. Use MUI TreeView with nodes that have partially selected children (indeterminate state) https://stackblitz.com/run?file=src%2FDemo.tsx.
  2. Inspect the native <input type="checkbox"> element in the indeterminate state.
  3. Notice it uses a data-indeterminate attribute but does not set aria-checked="mixed".
  4. Use a screen reader to verify that the indeterminate state is not announced.
2025-07-08_14-23-13.mp4

Current behavior

  • Instead of setting the ARIA state aria-checked="mixed", it uses a custom data-indeterminate attribute.
  • Screen readers ignore data-indeterminate, so they do not announce the indeterminate state.

Expected behavior

  • The checkbox input should have aria-checked="mixed" when in the indeterminate state.
  • This ensures that assistive technologies announce the partial selection properly.

Context

Your environment

npx @mui/envinfo
  Don't forget to mention which browser you used.
  Output from `npx @mui/envinfo` goes here.

Search keywords: TreeView, accessibility, aria-check

Metadata

Metadata

Assignees

No one assigned

    Labels

    a11yAccessibility: Issues or PRs related to making the application usable for people with disabilities.scope: tree viewChanges or issues related to the tree view producttype: bugA bug or unintended behavior in the components.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions