jsx-a11y/no-redundant-roles
Disallow role attributes that duplicate an element's implicit ARIA role, like <button role='button'>.
- Category: Accessibility
- Severity: warn
- Source:
oxlint-builtin:jsx-a11y - Framework: global
- Enabled when: always (unless customRulesOnly=true)
- Documentation: https://oxc.rs/docs/guide/usage/linter/rules/jsx_a11y/no-redundant-roles
Validation prompt
Use this to decide whether a fired diagnostic is real or a false positive.
Fires when role on a native element duplicates that element's implicit ARIA role, e.g. <button role='button'> or <img role='img'>. Default carve-out: <nav role='navigation'> is allowed per W3C guidance for legacy AT. False positive: an explicit role kept for an older screen reader that misreports the element's implicit role — increasingly rare in modern assistive tech.
Fix prompt
Use this once validation confirms the diagnostic is real.
Delete the redundant role attribute — the browser already exposes the correct role to assistive tech, and a duplicate role can actually break some ATs. If you genuinely need to override an element's semantics, reconsider the markup choice instead. Use the rule's options object to whitelist additional element/role pairs (like nav: ['navigation']) when needed. See https://oxc.rs/docs/guide/usage/linter/rules/jsx_a11y/no-redundant-roles
Related rules
More Accessibility rules from the rules reference:
react-doctor/alt-text: Require alternative text on img, area, input[type='image'], and object elements so screen readers can describe them.react-doctor/anchor-ambiguous-text: Describe a link's destination — avoid bare 'click here' / 'learn more' / 'link' as the only link text.react-doctor/anchor-has-content: Add visible or aria-labelled text inside every `<a>`.react-doctor/anchor-is-valid: Require anchors to navigate to a real destination — use a button for click-only actions instead of href='#' or javascript:void(0).react-doctor/aria-activedescendant-has-tabindex: Add `tabIndex` to elements with `aria-activedescendant` so they're keyboard-focusable.