Tabs ADA Title II non-compliant in horizontal orientation

Open
#42,677 4 comments 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 1 day

@sarathkumarsasi is already working on this.

Since Aug 7, 2026.

Assessment

Difficulty
3/5
Estimated time
1-2 days
Newbie friendliness
55/100
Issue type
Bug
Clarity
Mostly clear
Activity status
Quiet
Tech stack
javascript

Research direction

Start with the Bootstrap navs and tabs JavaScript behavior example and compare it with the minified Bootstrap bundle, focusing on ArrowUp and ArrowDown keydown handling in horizontal orientation. Verify the behavior against the WAI-ARIA tabs pattern and test the example in desktop browsers. Done means horizontal tabs no longer listen for those arrow keys while the documented tab behavior remains functional.

Written by the indexing model from the issue text.

Description

accessibility help-wanted v5 v6
Prerequisites
Describe the issue

Per WAI-ARIA tabs pattern, the up and down arrow keys should not be listened for in horizontal orientation. The Bootstrap example shows it being listened for. The minified bootstrap bundle shows it being listened for. I am unable to override it in my own code, leaving the websites I work on ADA Title II non-compliant where Tabs are used.

I have verified that nothing in my own code is listening for the ArrowDown nor ArrowUp keydown event.

Issue occurs in all desktop browsers.

Reduced test cases

See the Bootstrap example.

What operating system(s) are you seeing the problem on?

Windows

What browser(s) are you seeing the problem on?

Chrome

What version of Bootstrap are you using?

v5.3.8

Dominant language
MDX
Stars
175k
Forks
78.7k
Avg merge
1d 7h
Merged PRs (30d)
103

Getting set up

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.

More from twbs/bootstrap

All issues in twbs/bootstrap

Similar issues

More Accessibility issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.