KEMBAR78
Add support for ARIA 1.3 attributes by Abdul-Omira · Pull Request #34264 · facebook/react · GitHub
Skip to content

Conversation

Abdul-Omira
Copy link
Contributor

Summary

This PR adds support for new ARIA 1.3 accessibility attributes that enhance support for users with disabilities, particularly those using braille devices.

New Attributes Added:

  • aria-braillelabel: Provides specific labels for braille device users
  • aria-brailleroledescription: Provides role descriptions for braille devices
  • aria-colindextext: Provides human-readable text alternatives for column indices in tables/grids
  • aria-rowindextext: Provides human-readable text alternatives for row indices in tables/grids

These attributes were introduced in the ARIA 1.3 specification (First Public Working Draft, January 2024).

How did you test this change?

  1. Added the new ARIA 1.3 attributes to the validAriaProperties list in packages/react-dom-bindings/src/shared/validAriaProperties.js
  2. Created comprehensive tests in ReactDOMInvalidARIAHook-test.js that verify:
    • Each new attribute can be used without triggering warnings
    • Multiple ARIA 1.3 attributes can be used together
    • The attributes work correctly alongside existing ARIA attributes
  3. All existing tests continue to pass
  4. Ran yarn test ReactDOMInvalidARIAHook-test - all tests pass ✅
  5. Ran yarn linc - no linting issues ✅

Motivation

This change improves React's accessibility support by:

  • Bringing React up to date with the latest ARIA specifications
  • Providing better support for users with visual impairments who rely on braille devices
  • Allowing developers to provide more semantic information for table/grid navigation

This is a non-breaking change that only adds new valid attributes to the existing validation system.

Added support for new ARIA 1.3 accessibility attributes that enhance support for users with disabilities, particularly those using braille devices:

- aria-braillelabel: Provides specific labels for braille device users
- aria-brailleroledescription: Provides role descriptions for braille devices
- aria-colindextext: Provides human-readable text alternatives for column indices
- aria-rowindextext: Provides human-readable text alternatives for row indices

These attributes were introduced in the ARIA 1.3 specification (First Public Working Draft, January 2024) and improve React's accessibility support by allowing developers to provide enhanced context for assistive technologies.

Added comprehensive tests to verify that these new attributes are properly validated and don't trigger warnings when used correctly.
@meta-cla meta-cla bot added the CLA Signed label Aug 22, 2025
@react-sizebot
Copy link

react-sizebot commented Aug 22, 2025

Comparing: 11d7bcf...d77ec54

Critical size changes

Includes critical production bundles, as well as any change greater than 2%:

Name +/- Base Current +/- gzip Base gzip Current gzip
oss-stable/react-dom/cjs/react-dom.production.js = 6.68 kB 6.68 kB +0.11% 1.83 kB 1.83 kB
oss-stable/react-dom/cjs/react-dom-client.production.js = 530.18 kB 530.18 kB = 93.39 kB 93.39 kB
oss-experimental/react-dom/cjs/react-dom.production.js = 6.69 kB 6.69 kB +0.05% 1.83 kB 1.83 kB
oss-experimental/react-dom/cjs/react-dom-client.production.js = 655.82 kB 655.82 kB = 115.31 kB 115.31 kB
facebook-www/ReactDOM-prod.classic.js = 675.59 kB 675.59 kB = 118.54 kB 118.54 kB
facebook-www/ReactDOM-prod.modern.js = 666.02 kB 666.02 kB = 116.87 kB 116.87 kB

Significant size changes

Includes any change greater than 0.2%:

(No significant changes)

Generated by 🚫 dangerJS against d77ec54

Copy link
Collaborator

@eps1lon eps1lon left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank you!

@eps1lon eps1lon merged commit 698bb4d into facebook:main Aug 22, 2025
241 checks passed
github-actions bot pushed a commit that referenced this pull request Aug 22, 2025
Co-authored-by: Abdulwahab Omira <abdulwahabomira@gmail.com>
Co-authored-by: Sebastian Sebbie Silbermann <sebastian.silbermann@vercel.com>

DiffTrain build for [698bb4d](698bb4d)
github-actions bot pushed a commit that referenced this pull request Aug 22, 2025
Co-authored-by: Abdulwahab Omira <abdulwahabomira@gmail.com>
Co-authored-by: Sebastian Sebbie Silbermann <sebastian.silbermann@vercel.com>

DiffTrain build for [698bb4d](698bb4d)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants