bootstrap-forced-colors-css

Bootstrap Forced Colors CSS


Enhances the accessibility of Bootstrap 5 when using with Contrast themes in Windows.

This CSS file fixes many issues and adds enhancements to make Bootstrap 5 more accessible in Firefox, Chrome, Edge on Windows using the forced-colors: active media query.

Quick start

- Download the latest release
- Clone the repository git clone https://github.com/coliff/bootstrap-forced-colors-css.git
- Install with npm npm install bootstrap-forced-colors-css
- Install with Yarn yarn add bootstrap-forced-colors-css
- Install with Composer composer require coliff/bootstrap-forced-colors-css

Usage

Add this in the which will load the CSS using a media query as follow:

``html

`

The CSS can be loaded via a CDN:

`html
rel="stylesheet"
href="https://cdn.jsdelivr.net/npm/bootstrap-forced-colors-css@1.0.7/css/bootstrap-forced-colors.min.css"
media="screen and (forced-colors: active)">
`

Or you can import the CSS into your own CSS file:

`scss
@import bootstrap-forced-colors.min.css
`

> [!NOTE]
> bootstrap-forced-colors-css improves the accessibility of Bootstrap 5 for Windows users in forced colors mode, but you should still test your site to ensure it meets your accessibility requirements.

FAQS

$3

- Accordion buttons have improved contrast in dark mode
- Badges within buttons have a 1px border to improve contrast
- Buttons have improved focus state contrast (2px visible outline rather than 1px)
- Disabled buttons display the correct color using the GrayText name
- Carousel indicators have background-color issue resolved
- Close button has improved contrast by reducing the opacity
- Dropdown toggle arrows appear correctly (as triangles and not rectangles)
- List Group disabled items display the correct color using the GrayText name
- Modal backdrop opacity changed from 0.5 to 0.8
- Navbar Menu (hamburger) toggle icons display correctly
- Navs Improves active and focus state contrast
- Pagination: Active page link has outline to indicate active page
- Pagination: Disabled page link display the correct color using the GrayText name
- Placeholder: Fix for invisible placeholder boxes
- Popovers: Fixes invisible arrow issue
- Progress: Is no longer invisible
- Progress: Improved stacked progress bar contrast
- Spinners: Fixes animation
- Tables: Have a 1px outline to improve contrast
- Toasts: Fixes invisible close/dismiss button
- Tooltips: Fix for arrows appearing as rectangles
- Tooltips: Add 1px border to tooltips content
- Vertical Rule: Fixes invisible vertical rule
- Horizontal Rule: Improves contrast by changing opacity from 0.25 to 0.5

$3

- Check the open issues at GitHub.

Demo

See this in action at: https://coliff.github.io/bootstrap-forced-colors-css/tests/

Testing

Currently, only Windows 10 & 11 with Edge, Firefox, and Chrome support forced colors mode. To test, you can enable forced colors mode in:

- Windows 10: Go to Settings > Ease of Access > High contrast and select a theme.
- Windows 11: Go to Settings > Accessibility > Contrast themes and select a theme.

You can also use the Forced Colors Mode Emulation in Edge and Chrome on all platforms.

> [!NOTE]
> By default, the Forced Colors Mode emulation is a dark mode theme, but you can switch to a light theme by forcing the prefers-color-scheme` to light in the Dev Tools. Remember that the user can't use Bootstrap's light/dark mode theme toggle. The color scheme is set by the user at the OS level.

Note that CanIUse lists Safari as supporting forced colors mode, however macOS itself doesn't have a Forced Colors / High Contrast mode which means it's not possible to use this with Safari at all.