mui / mui/material-ui

[button] Allow receiving focus when `disabled`

Open
#32,917 11 comments 7 reactions 1 assignee View on GitHub

Nobody has claimed this yet.

accessibility priority: important scope: button type: new feature
Dominant language
JavaScript
Stars
99.1k
Forks
32.5k
Avg merge
2d 17h
Merged PRs (30d)
106

Description

Summary 💡

focusableWhenDisabled prop for UnstyledButton has been recently implemented (#32090). The docs claim:

Similarly to the native HTML element, the ButtonUnstyled component can't receive focus when it's disabled. This may reduce its accessibility, as screen readers won't be able to announce the existence and state of the button.

The focusableWhenDisabled prop lets you change this behavior. When this prop is set, the underlying button does not set the disabled prop. Instead, aria-disabled is used, which makes the button focusable.

This should be used whenever the disabled button needs to be read by screen readers.

The same reasoning should be applicable to the MUI Button and Checkbox components

Examples 🌈

See https://mui.com/base/react-button/#focus-on-disabled-buttons

Motivation 🔦

Make <Button disabled /> and <Checkbox disabled> accessible

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.