From c240135d11054816d768d855008eafbc0d67e08e Mon Sep 17 00:00:00 2001 From: Kathy Eng Date: Fri, 7 Feb 2025 16:42:14 +0000 Subject: [PATCH 1/9] new manual rule --- _rules/video-captions-correct.md | 160 +++++++++++++++++++++++++++++++ _rules/video-captions-f51b46.md | 34 ++++--- 2 files changed, 179 insertions(+), 15 deletions(-) create mode 100644 _rules/video-captions-correct.md diff --git a/_rules/video-captions-correct.md b/_rules/video-captions-correct.md new file mode 100644 index 00000000000..4858f39c9a4 --- /dev/null +++ b/_rules/video-captions-correct.md @@ -0,0 +1,160 @@ +--- +id: +name: Video element auditory content has correct captions +rules_format: 1.1 +rule_type: atomic +description: | + This rule checks that provided captions are correct for audio information in non-streaming `video` elements. +accessibility_requirements: + wcag20:1.2.2: # Captions (Prerecorded) (A) + forConformance: true + failed: not satisfied + passed: further testing needed + inapplicable: further testing needed + wcag20:1.2.4: # Captions (Live) (AA) + forConformance: true + failed: not satisfied + passed: further testing needed + inapplicable: further testing needed + wcag-technique:F8: # Failure of Success Criterion 1.2.2 due to captions omitting some dialogue or important sound effects + forConformance: false + failed: not satisfied + passed: further testing needed + inapplicable: further testing needed + wcag-technique:F75: # Failure of Success Criterion 1.2.2 by providing synchronized media without captions when the synchronized media presents more information than is presented on the page + forConformance: false + failed: not satisfied + passed: further testing needed + inapplicable: further testing needed +input_aspects: + - DOM Tree + - CSS Styling + - Audio output + - Visual output +acknowledgments: + authors: + - Kathy Eng + funding: + - WAI-Tools + assets: + - Web Accessibility Perspective videos by W3C WAI. +--- + +## Applicability + +This rule applies to [captions](https://www.w3.org/TR/WCAG22/#dfn-captions) provided for a [non-streaming](#non-streaming-media-element) `video` element that is [visible][]where the video contains [audio](#audio-output). + +## Expectation + +For each test target, speech and non-speech audio information that is not conveyed visually in the video is available in the [captions](https://www.w3.org/TR/WCAG22/#dfn-captions). + +**Note:** Captions can be either embedded in the video file itself or can be made available through a separate track. + +## Background + +### Assumptions + +This rule assumes that the video element is used to play a video (for example, not only used to display an image), and that there is a mechanism to start the video. + +### Accessibility Support + +There are no accessibility support issues known. + +### Related Rules + +- [Video element auditory content has captions](https://www.w3.org/WAI/standards-guidelines/act/rules/f51b46/proposed/) +- [Video element auditory content has accessible alternative](https://www.w3.org/WAI/standards-guidelines/act/rules/eac66b/proposed/) + +### Bibliography + +- [Understanding Success Criterion 1.2.2: Captions (Prerecorded)](https://www.w3.org/WAI/WCAG22/Understanding/captions-prerecorded) +- [F8: Failure of Success Criterion 1.2.2 due to captions omitting some dialogue or important sound effects](https://www.w3.org/WAI/WCAG22/Techniques/failures/F8) +- [F75: Failure of Success Criterion 1.2.2 by providing synchronized media without captions when the synchronized media presents more information than is presented on the page](https://www.w3.org/WAI/WCAG22/Techniques/failures/F75) + +## Test Cases + +### Passed + +#### Passed Example 1 + +The open captions contain all of the audio content. + +```html + +``` + +#### Passed Example 2 + +The closed captions contain all of the audio content. + +```html + +``` + +### Failed + +#### Failed Example 1 + +A video element with an associated track element that contains incorrect captions. Specifically, the captions flip the role of the mouse and computer by saying, "Not being able to use your mouse because your computer doesn't work is frustrating." + +```html + +``` + +### Inapplicable + +#### Inapplicable Example 1 + +A video element without audio. + +```html + +``` + +#### Inapplicable Example 2 + +A video element that is not [visible][]. + +```html + +``` + +#### Inapplicable Example 3 + +A video element without any form of captions. + +```html + +``` + +#### Inapplicable Example 4 + +A video element with text on the same page that describes the audio in the video. + +```html +

+ The video below shows a man working on a keyboard. A voiceover is heard saying the following text: Web accessibility + perspectives. Keyboard compatibility. Not being able to use your computer because your mouse doesn't work, is + frustrating. Many people use only the keyboard to navigate websites. Either through preference or circumstance. +

+ +``` + +#### Inapplicable Example 5 + +A video element with an explicitly associated text on the same page that describes the audio in the video. + +```html +

+ The video below shows a man working on a keyboard. A voiceover is heard saying the following text: Web accessibility + perspectives. Keyboard compatibility. Not being able to use your computer because your mouse doesn't work, is + frustrating. Many people use only the keyboard to navigate websites. Either through preference or circumstance. +

+ +``` + +[visible]: #visible 'Definition of visible' diff --git a/_rules/video-captions-f51b46.md b/_rules/video-captions-f51b46.md index da050232b8f..8e261af28aa 100755 --- a/_rules/video-captions-f51b46.md +++ b/_rules/video-captions-f51b46.md @@ -44,7 +44,7 @@ This rule applies to every [non-streaming](#non-streaming-media-element) `video` ## Expectation -For each test target, audio information that is not conveyed visually in the video, is available through [captions](https://www.w3.org/TR/WCAG22/#dfn-captions). +For each test target, [captions](https://www.w3.org/TR/WCAG22/#dfn-captions) are provided. **Note:** Captions can be either embedded in the video file itself or can be made available trough a separate track. @@ -58,6 +58,10 @@ This rule assumes that the video element is used to play a video (for example, n There are no accessibility support issues known. +### Related Rules + +This rule does not evaluate the captions for accuracy or quality. See Video element auditory content has correct captions. + ### Bibliography - [Understanding Success Criterion 1.2.2: Captions (Prerecorded)](https://www.w3.org/WAI/WCAG22/Understanding/captions-prerecorded) @@ -79,7 +83,7 @@ A video element that has open captions for all of the audio content. #### Passed Example 2 -A video element with an associated track element that contains captions for all of the audio content. +A video element has closed captions. ```html ``` +#### Passed Example 3 + +A video element with an associated track element that contains incorrect captions. This rule does not evaluate the captions for accuracy or quality. + +```html + +``` + ### Failed #### Failed Example 1 @@ -99,17 +113,7 @@ A video element without any form of captions. #### Failed Example 2 -A video element with an associated track element that contains incorrect captions. Specifically, the captions flip the role of the mouse and computer by saying, "Not being able to use your mouse because your computer doesn't work is frustrating." - -```html - -``` - -#### Failed Example 3 - -A video element with text on the same page that describes the audio in the video. +A video element with text on the same page that describes the audio in the video but no captions. ```html

@@ -120,9 +124,9 @@ A video element with text on the same page that describes the audio in the video ``` -#### Failed Example 4 +#### Failed Example 3 -A video element with an explicitly associated text on the same page that describes the audio in the video. +A video element with an explicitly associated text on the same page that describes the audio in the video but no captions. ```html

From fdb3a9ef3a46e838320e1b8977ba7880fd9a9449 Mon Sep 17 00:00:00 2001 From: Kathy Eng Date: Fri, 7 Feb 2025 17:11:48 +0000 Subject: [PATCH 2/9] add id --- ...deo-captions-correct.md => video-captions-correct-a3b9xz.md} | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) rename _rules/{video-captions-correct.md => video-captions-correct-a3b9xz.md} (99%) diff --git a/_rules/video-captions-correct.md b/_rules/video-captions-correct-a3b9xz.md similarity index 99% rename from _rules/video-captions-correct.md rename to _rules/video-captions-correct-a3b9xz.md index 4858f39c9a4..f3ad0fa4fc4 100644 --- a/_rules/video-captions-correct.md +++ b/_rules/video-captions-correct-a3b9xz.md @@ -1,5 +1,5 @@ --- -id: +id: a3b9xz name: Video element auditory content has correct captions rules_format: 1.1 rule_type: atomic From 3d1378bffcc57df750827580b7e9753ba4f76d34 Mon Sep 17 00:00:00 2001 From: Kathy Eng Date: Fri, 7 Feb 2025 17:16:39 +0000 Subject: [PATCH 3/9] correct spelling error --- _rules/video-captions-correct-a3b9xz.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_rules/video-captions-correct-a3b9xz.md b/_rules/video-captions-correct-a3b9xz.md index f3ad0fa4fc4..ec9c257d20f 100644 --- a/_rules/video-captions-correct-a3b9xz.md +++ b/_rules/video-captions-correct-a3b9xz.md @@ -42,7 +42,7 @@ acknowledgments: ## Applicability -This rule applies to [captions](https://www.w3.org/TR/WCAG22/#dfn-captions) provided for a [non-streaming](#non-streaming-media-element) `video` element that is [visible][]where the video contains [audio](#audio-output). +This rule applies to [captions](https://www.w3.org/TR/WCAG22/#dfn-captions) provided for a [non-streaming](#non-streaming-media-element) `video` element that is [visible][] where the video contains [audio](#audio-output). ## Expectation From 1fc75a0cb3762f588ef1dde9775f6a173531c8cc Mon Sep 17 00:00:00 2001 From: Kathy Eng Date: Fri, 7 Feb 2025 17:27:57 +0000 Subject: [PATCH 4/9] add me to contributor array --- package.json | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/package.json b/package.json index fe780b9d4cd..32c0afb979f 100644 --- a/package.json +++ b/package.json @@ -131,6 +131,10 @@ { "name": "Helen Burge", "url": "https://github.com/HelenBurge" + }, + { + "name": "Kathy Eng", + "url": "https://github.com/kengdoj" } ], "devDependencies": { From 63040f18a9bf523f29ba97b1f13d76af556a4271 Mon Sep 17 00:00:00 2001 From: Kathy Eng Date: Thu, 20 Feb 2025 10:18:59 -0500 Subject: [PATCH 5/9] Update video-captions-f51b46.md --- _rules/video-captions-f51b46.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_rules/video-captions-f51b46.md b/_rules/video-captions-f51b46.md index 8e261af28aa..d33a69d3089 100755 --- a/_rules/video-captions-f51b46.md +++ b/_rules/video-captions-f51b46.md @@ -134,7 +134,7 @@ A video element with an explicitly associated text on the same page that describ perspectives. Keyboard compatibility. Not being able to use your computer because your mouse doesn't work, is frustrating. Many people use only the keyboard to navigate websites. Either through preference or circumstance.

- + ``` ### Inapplicable From bc266c0340a179da50add110dee85efa5b115114 Mon Sep 17 00:00:00 2001 From: Kathy Eng Date: Thu, 20 Feb 2025 10:20:41 -0500 Subject: [PATCH 6/9] Apply suggestions from code review Co-authored-by: Dan Tripp <113939352+dan-tripp-siteimprove@users.noreply.github.com> --- _rules/video-captions-f51b46.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/_rules/video-captions-f51b46.md b/_rules/video-captions-f51b46.md index d33a69d3089..779b3de82c0 100755 --- a/_rules/video-captions-f51b46.md +++ b/_rules/video-captions-f51b46.md @@ -60,7 +60,7 @@ There are no accessibility support issues known. ### Related Rules -This rule does not evaluate the captions for accuracy or quality. See Video element auditory content has correct captions. +This rule does not evaluate the captions for accuracy or quality. See [Video element auditory content has correct captions](https://www.w3.org/WAI/standards-guidelines/act/rules/a3b9xz/). ### Bibliography @@ -113,7 +113,7 @@ A video element without any form of captions. #### Failed Example 2 -A video element with text on the same page that describes the audio in the video but no captions. +A video element with text on the same page that describes the audio in the video, but the video itself has no captions. ```html

@@ -126,7 +126,7 @@ A video element with text on the same page that describes the audio in the video #### Failed Example 3 -A video element with an explicitly associated text on the same page that describes the audio in the video but no captions. +A video element with an explicitly associated text on the same page that describes the audio in the video, but the video itself has no captions. ```html

From 7b3dabfa5944c88372bb15109004a63837c2591c Mon Sep 17 00:00:00 2001 From: Kathy Eng Date: Thu, 12 Jun 2025 11:00:18 -0400 Subject: [PATCH 7/9] Update _rules/video-captions-correct-a3b9xz.md Co-authored-by: Wilco Fiers --- _rules/video-captions-correct-a3b9xz.md | 5 ----- 1 file changed, 5 deletions(-) diff --git a/_rules/video-captions-correct-a3b9xz.md b/_rules/video-captions-correct-a3b9xz.md index ec9c257d20f..6688eab05c4 100644 --- a/_rules/video-captions-correct-a3b9xz.md +++ b/_rules/video-captions-correct-a3b9xz.md @@ -11,11 +11,6 @@ accessibility_requirements: failed: not satisfied passed: further testing needed inapplicable: further testing needed - wcag20:1.2.4: # Captions (Live) (AA) - forConformance: true - failed: not satisfied - passed: further testing needed - inapplicable: further testing needed wcag-technique:F8: # Failure of Success Criterion 1.2.2 due to captions omitting some dialogue or important sound effects forConformance: false failed: not satisfied From 1d85691a87513bcfb9890d54f638a68d384a61c3 Mon Sep 17 00:00:00 2001 From: Kathy Eng Date: Thu, 12 Jun 2025 12:04:06 -0400 Subject: [PATCH 8/9] Update _rules/video-captions-correct-a3b9xz.md --- _rules/video-captions-correct-a3b9xz.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/_rules/video-captions-correct-a3b9xz.md b/_rules/video-captions-correct-a3b9xz.md index 6688eab05c4..b16b6cdc25d 100644 --- a/_rules/video-captions-correct-a3b9xz.md +++ b/_rules/video-captions-correct-a3b9xz.md @@ -49,6 +49,8 @@ For each test target, speech and non-speech audio information that is not convey ### Assumptions +This rule assumes that the [non-streaming](#non-streaming-media-element) video is not a media alternative for text. + This rule assumes that the video element is used to play a video (for example, not only used to display an image), and that there is a mechanism to start the video. ### Accessibility Support From b87a8ba8fef41fe3cdc798a13dccb0434e244b13 Mon Sep 17 00:00:00 2001 From: Kathy Eng Date: Thu, 3 Jul 2025 13:51:05 -0400 Subject: [PATCH 9/9] Update _rules/video-captions-f51b46.md --- _rules/video-captions-f51b46.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_rules/video-captions-f51b46.md b/_rules/video-captions-f51b46.md index 779b3de82c0..2ac6c0265b1 100755 --- a/_rules/video-captions-f51b46.md +++ b/_rules/video-captions-f51b46.md @@ -44,7 +44,7 @@ This rule applies to every [non-streaming](#non-streaming-media-element) `video` ## Expectation -For each test target, [captions](https://www.w3.org/TR/WCAG22/#dfn-captions) are provided. +For each test target, [captions](https://www.w3.org/TR/WCAG22/#dfn-captions) are provided for audio information that is not conveyed visually in the video. **Note:** Captions can be either embedded in the video file itself or can be made available trough a separate track.