Skip to content

Commit 3083596

Browse files
Docs: update WCAG links and references (#40703)
Co-authored-by: Julien Déramond <[email protected]>
1 parent 4e954ea commit 3083596

File tree

7 files changed

+10
-10
lines changed

7 files changed

+10
-10
lines changed

.github/CONTRIBUTING.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -221,7 +221,7 @@ includes code changes) and under the terms of the
221221

222222
[Adhere to the Code Guide.](https://codeguide.co/#css)
223223

224-
- When feasible, default color palettes should comply with [WCAG color contrast guidelines](https://www.w3.org/TR/WCAG20/#visual-audio-contrast).
224+
- When feasible, default color palettes should comply with [WCAG color contrast guidelines](https://www.w3.org/TR/WCAG/#distinguishable).
225225
- Except in rare cases, don't remove default `:focus` styles (via e.g. `outline: none;`) without providing alternative styles. See [this A11Y Project post](https://www.a11yproject.com/posts/2013-01-25-never-remove-css-outlines/) for more details.
226226

227227
### JS

scss/_functions.scss

+1-1
Original file line numberDiff line numberDiff line change
@@ -177,7 +177,7 @@ $_luminance-list: .0008 .001 .0011 .0013 .0015 .0017 .002 .0022 .0025 .0027 .003
177177
@return if($l1 > $l2, divide($l1 + .05, $l2 + .05), divide($l2 + .05, $l1 + .05));
178178
}
179179

180-
// Return WCAG2.1 relative luminance
180+
// Return WCAG2.2 relative luminance
181181
// See https://www.w3.org/TR/WCAG/#dfn-relative-luminance
182182
// See https://www.w3.org/TR/WCAG/#dfn-contrast-ratio
183183
@function luminance($color) {

scss/_variables.scss

+2-2
Original file line numberDiff line numberDiff line change
@@ -67,8 +67,8 @@ $colors: (
6767
) !default;
6868
// scss-docs-end colors-map
6969

70-
// The contrast ratio to reach against white, to determine if color changes from "light" to "dark". Acceptable values for WCAG 2.0 are 3, 4.5 and 7.
71-
// See https://www.w3.org/TR/WCAG20/#visual-audio-contrast-contrast
70+
// The contrast ratio to reach against white, to determine if color changes from "light" to "dark". Acceptable values for WCAG 2.2 are 3, 4.5 and 7.
71+
// See https://www.w3.org/TR/WCAG/#contrast-minimum
7272
$min-contrast-ratio: 4.5 !default;
7373

7474
// Customize the light and dark text colors for use in our color contrast function.

scss/mixins/_visually-hidden.scss

+1-1
Original file line numberDiff line numberDiff line change
@@ -24,7 +24,7 @@
2424
// Use to only display content when it's focused, or one of its child elements is focused
2525
// (i.e. when focus is within the element/container that the class was applied to)
2626
//
27-
// Useful for "Skip to main content" links; see https://www.w3.org/TR/2013/NOTE-WCAG20-TECHS-20130905/G1
27+
// Useful for "Skip to main content" links; see https://www.w3.org/WAI/WCAG22/Techniques/general/G1.html
2828

2929
@mixin visually-hidden-focusable() {
3030
&:not(:focus):not(:focus-within) {

site/content/docs/5.3/components/carousel.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -165,7 +165,7 @@ You can make your carousels autoplay on page load by setting the `ride` option t
165165
{{< callout info >}}
166166
For accessibility reasons, we recommend avoiding the use of autoplaying carousels. If your page does include an autoplaying carousel, we recommend providing an additional button or control to explicitly pause/stop the carousel.
167167

168-
See [WCAG 2.1 Success Criterion 2.2.2 Pause, Stop, Hide](https://www.w3.org/TR/WCAG21/#pause-stop-hide).
168+
See [WCAG 2.2 Success Criterion 2.2.2 Pause, Stop, Hide](https://www.w3.org/TR/WCAG/#pause-stop-hide).
169169
{{< /callout >}}
170170

171171
{{< example >}}

site/content/docs/5.3/getting-started/accessibility.md

+3-3
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ Bootstrap provides an easy-to-use framework of ready-made styles, layout tools,
1010

1111
## Overview and limitations
1212

13-
The overall accessibility of any project built with Bootstrap depends in large part on the author's markup, additional styling, and scripting they've included. However, provided that these have been implemented correctly, it should be perfectly possible to create websites and applications with Bootstrap that fulfill [<abbr title="Web Content Accessibility Guidelines">WCAG</abbr> 2.1](https://www.w3.org/TR/WCAG/) (A/AA/AAA), [Section 508](https://www.section508.gov/), and similar accessibility standards and requirements.
13+
The overall accessibility of any project built with Bootstrap depends in large part on the author's markup, additional styling, and scripting they've included. However, provided that these have been implemented correctly, it should be perfectly possible to create websites and applications with Bootstrap that fulfill [<abbr title="Web Content Accessibility Guidelines">WCAG</abbr> 2.2](https://www.w3.org/TR/WCAG/) (A/AA/AAA), [Section 508](https://www.section508.gov/), and similar accessibility standards and requirements.
1414

1515
### Structural markup
1616

@@ -24,7 +24,7 @@ Because Bootstrap's components are purposely designed to be fairly generic, auth
2424

2525
### Color contrast
2626

27-
Some combinations of colors that currently make up Bootstrap's default palette—used throughout the framework for things such as button variations, alert variations, form validation indicators—may lead to *insufficient* color contrast (below the recommended [WCAG 2.1 text color contrast ratio of 4.5:1](https://www.w3.org/TR/WCAG/#contrast-minimum) and the [WCAG 2.1 non-text color contrast ratio of 3:1](https://www.w3.org/TR/WCAG/#non-text-contrast)), particularly when used against a light background. Authors are encouraged to test their specific uses of color and, where necessary, manually modify/extend these default colors to ensure adequate color contrast ratios.
27+
Some combinations of colors that currently make up Bootstrap's default palette—used throughout the framework for things such as button variations, alert variations, form validation indicators—may lead to *insufficient* color contrast (below the recommended [WCAG 2.2 text color contrast ratio of 4.5:1](https://www.w3.org/TR/WCAG/#contrast-minimum) and the [WCAG 2.2 non-text color contrast ratio of 3:1](https://www.w3.org/TR/WCAG/#non-text-contrast)), particularly when used against a light background. Authors are encouraged to test their specific uses of color and, where necessary, manually modify/extend these default colors to ensure adequate color contrast ratios.
2828

2929
### Visually hidden content
3030

@@ -51,7 +51,7 @@ On browsers that support `prefers-reduced-motion`, and where the user has *not*
5151

5252
## Additional resources
5353

54-
- [Web Content Accessibility Guidelines (WCAG) 2.1](https://www.w3.org/TR/WCAG/)
54+
- [Web Content Accessibility Guidelines (WCAG) 2.2](https://www.w3.org/TR/WCAG/)
5555
- [The A11Y Project](https://www.a11yproject.com/)
5656
- [MDN accessibility documentation](https://developer.mozilla.org/en-US/docs/Web/Accessibility)
5757
- [Tenon.io Accessibility Checker](https://tenon.io/)

site/content/docs/5.3/migration.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -431,7 +431,7 @@ Want more information? [Read the v5.1.0 blog post.](https://blog.getbootstrap.co
431431

432432
- Added new tints and shades for every color, providing nine separate colors for each base color, as new Sass variables.
433433

434-
- Improved color contrast. Bumped color contrast ratio from 3:1 to 4.5:1 and updated blue, green, cyan, and pink colors to ensure WCAG 2.1 AA contrast. Also changed our color contrast color from `$gray-900` to `$black`.
434+
- Improved color contrast. Bumped color contrast ratio from 3:1 to 4.5:1 and updated blue, green, cyan, and pink colors to ensure WCAG 2.2 AA contrast. Also changed our color contrast color from `$gray-900` to `$black`.
435435

436436
- To support our color system, we've added new custom `tint-color()` and `shade-color()` functions to mix our colors appropriately.
437437

0 commit comments

Comments
 (0)