Update ee13b5 and 1a02b0 rules to clarify that transcript for video content does not need to be visible #2187
+92
−8
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -15,6 +15,10 @@ accessibility_requirements: | |
| failed: not satisfied | ||
| passed: further testing needed | ||
| inapplicable: further testing needed | ||
| wcag20:1.3.1: # Info and Relationships (A) | ||
| secondary: This success criterion is **related** to this rule. This is because this criterion applies to a visible transcript. | ||
| wcag20:1.2.1: # Audio-only and Video-only (Prerecorded) (A) | ||
| secondary: This success criterion is **less strict** than this rule. This is because this criterion does not require a transcript when the audio-only or video-only is a media alternative for text and is clearly labeled as such. Some of the failed examples may satisfy this success criterion. | ||
| input_aspects: | ||
| - DOM Tree | ||
| - CSS Styling | ||
|
|
@@ -41,13 +45,14 @@ This rule applies to every [non-streaming](#non-streaming-media-element) `video` | |
|
|
||
| ## Expectation | ||
|
|
||
| The visual information of each test target is available through a text transcript that is [included in the accessibility tree][], and is either on the page or linked. | ||
|
|
||
| **Note:** A "text transcript" in the context of this rule is defined in WCAG 2 as an [alternative for time based media](https://www.w3.org/TR/WCAG22/#dfn-alternative-for-time-based-media). | ||
|
|
||
| ## Assumptions | ||
|
|
||
| - This rule assumes that a mechanism is available to start the video and that the video element is not simply used to display the [poster](https://www.w3.org/TR/html5/semantics-embedded-content.html#element-attrdef-video-poster). | ||
| - Users who are not visually impaired can comprehend the contents of the video through visual cues and information presented visually. | ||
|
|
||
| ## Accessibility Support | ||
|
|
||
|
|
@@ -69,7 +74,7 @@ There are no accessibility support issues known. | |
|
|
||
| #### Passed Example 1 | ||
|
|
||
| A video element with a visible text transcript on the same page. | ||
|
|
||
| ```html | ||
| <html lang="en">` | ||
|
|
@@ -97,6 +102,34 @@ A video element with a link to a text transcript on a different page. | |
| </html> | ||
| ``` | ||
|
|
||
| #### Passed Example 3 | ||
|
|
||
| This `video` element has a non-visible text transcript available on the same page. | ||
|
|
||
| ```html | ||
| <html lang="en"> | ||
| <video controls> | ||
| <source src="/test-assets/rabbit-video/video.mp4" type="video/mp4"></source> | ||
| <source src="/test-assets/rabbit-video/video.webm" type="video/webm"></source> | ||
| </video> | ||
| <p style="position:absolute; left:-9999px; top:auto; width:1px; height:1px; overflow:hidden;">The above video shows a giant fat rabbit climbing out of a hole in the ground. | ||
| He stretches, yaws, and then starts walking. | ||
| Then he stops to scratch his bottom.</p> | ||
| </html> | ||
| ``` | ||
|
|
||
|
giacomo-petri marked this conversation as resolved.
|
||
| #### Passed Example 4 | ||
|
|
||
| A video element with an associated track element that contains captions for all the audio and a transcript on the page. | ||
|
|
||
| ```html | ||
| <html lang="en"> | ||
| <video src="/test-assets/perspective-video/perspective-video.mp4" controls> | ||
| <track src="/test-assets/perspective-video/perspective-caption.vtt" kind="captions" /> | ||
| </video> | ||
| <p> Web Accessibility Perspectives: Keyboard Accessibility. Not being able to use your computer because your mouse doesn't work, is frustrating. (A computer user's mouse breaks when it falls off the desk.) Many people use only the keyboard to navigate websites. Either through preference or circumstance. (A person wearing a sling on her arm typing with one hand.) </p> | ||
| </html> | ||
| ``` | ||
|
kengdoj marked this conversation as resolved.
|
||
| ### Failed | ||
|
|
||
| #### Failed Example 1 | ||
|
|
@@ -129,6 +162,33 @@ A video element with a link to an incorrect text transcript on a different page. | |
| </html> | ||
| ``` | ||
|
|
||
| #### Failed Example 3 | ||
|
|
||
| This `video` element has a text transcript available on the same page, but the transcript is not [included in the accessibility tree][]. | ||
|
|
||
| ```html | ||
|
giacomo-petri marked this conversation as resolved.
|
||
| <html lang="en"> | ||
| <video controls> | ||
| <source src="/test-assets/rabbit-video/video.mp4" type="video/mp4"></source> | ||
| <source src="/test-assets/rabbit-video/video.webm" type="video/webm"></source> | ||
| </video> | ||
| <p aria-hidden="true">The above video shows a giant fat rabbit climbing out of a hole in the ground. | ||
| He stretches, yaws, and then starts walking. | ||
| Then he stops to scratch his bottom.</p> | ||
| </html> | ||
| ``` | ||
|
|
||
|
Comment on lines
+151
to
+182
Collaborator
Author
There was a problem hiding this comment. Thanks for catching that. Requested more details in #2186
Collaborator
There was a problem hiding this comment. This PR is removing "included in the accessibility tree" from the expectation. This will be a passed example since a transcript is available.
Member
There was a problem hiding this comment. This PR is the correct direction. We remove the change from 2064. AG decided that transcripts aren't strictly required to be visible.
giacomo-petri marked this conversation as resolved.
|
||
| #### Failed Example 4 | ||
|
|
||
| A video element with audio does not have a text transcript. | ||
|
|
||
| ```html | ||
| <html lang="en"> | ||
| <video src="/test-assets/perspective-video/perspective-video.mp4" controls> | ||
| <track src="/test-assets/perspective-video/perspective-caption.vtt" kind="captions" /> | ||
| </video> | ||
| </html> | ||
| ``` | ||
|
kengdoj marked this conversation as resolved.
|
||
| ### Inapplicable | ||
|
|
||
| #### Inapplicable Example 1 | ||
|
|
||
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Uh oh!
There was an error while loading. Please reload this page.