From c240135d11054816d768d855008eafbc0d67e08e Mon Sep 17 00:00:00 2001 From: Kathy Eng Date: Fri, 7 Feb 2025 16:42:14 +0000 Subject: [PATCH 1/6] 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 0000000000..4858f39c9a --- /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 da050232b8..8e261af28a 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/6] 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 4858f39c9a..f3ad0fa4fc 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/6] 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 f3ad0fa4fc..ec9c257d20 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/6] add me to contributor array --- package.json | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/package.json b/package.json index fe780b9d4c..32c0afb979 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/6] 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 8e261af28a..d33a69d308 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/6] 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 d33a69d308..779b3de82c 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