Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update ee13b5 and 1a02b0 rules to clarify that transcript for video content does not need to be visible #2187

Open
wants to merge 4 commits into
base: develop
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
30 changes: 25 additions & 5 deletions _rules/video-only-transcript-ee13b5.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,9 @@ 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 the absence of a transcript means that information conveyed through visual means in the video-only content remains inaccessible to certain users, thus creating inequality in communication.

input_aspects:
- DOM Tree
- CSS Styling
Expand All @@ -36,11 +39,12 @@ This rule applies to any [non-streaming](#non-streaming-media-element) `video` e

## Expectation

The visual information of each test target is available through a text transcript that is [visible][], [included in the accessibility tree][], and is either on the page or linked.
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.

## Assumptions

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).
- 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

Expand All @@ -61,7 +65,7 @@ A "text transcript" in the context of this rule is defined in WCAG 2 as an [alte

#### Passed Example 1

This `video` element, which has no audio, has a text transcript available on the same page.
This `video` element, which has no audio, has a visible text transcript available on the same page.

```html
<html lang="en">
Expand Down Expand Up @@ -89,6 +93,22 @@ This `video` element, which has no audio, has a transcript which conveys informa
</html>
```

#### Passed Example 3

This `video` element, which has no audio, has a non-visible text transcript available on the same page.

```html
<html lang="en">
<video controls>
<source src="/test-assets/rabbit-video/silent.mp4" type="video/mp4"></source>
<source src="/test-assets/rabbit-video/silent.webm" type="video/webm"></source>
</video>
<p style="position:absolute; left:-9999px; top:auto; width:1px; height:1px; overflow:hidden;">This video shows a giant fat rabbit climbing out of a hole in the ground.
He stretches, yawns, and then starts walking.
Then he stops to scratch his bottom.</p>
</html>
```

### Failed

#### Failed Example 1
Expand Down Expand Up @@ -131,7 +151,7 @@ This `video` element, which has no audio, has a text transcript available on the
<source src="/test-assets/rabbit-video/silent.mp4" type="video/mp4"></source>
<source src="/test-assets/rabbit-video/silent.webm" type="video/webm"></source>
</video>
<p style="text-indent: -9999px;">The above video shows a giant fat rabbit climbing out of a hole in the ground.
<p style="text-indent: -9999px;">This video shows a giant fat rabbit climbing out of a hole in the ground.
He stretches, yawns, and then starts walking.
Then he stops to scratch his bottom.</p>
</html>
Expand All @@ -147,7 +167,7 @@ This `video` element, which has no audio, has a text transcript available on the
<source src="/test-assets/rabbit-video/silent.mp4" type="video/mp4"></source>
<source src="/test-assets/rabbit-video/silent.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.
<p aria-hidden="true">This video shows a giant fat rabbit climbing out of a hole in the ground.
He stretches, yawns, and then starts walking.
Then he stops to scratch his bottom.</p>
</html>
Expand Down
39 changes: 36 additions & 3 deletions _rules/video-transcript-1a02b0.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,6 +15,8 @@ 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 the absence of a transcript means that information conveyed through visual means in the video content remains inaccessible to certain users, thus creating inequality in communication.
input_aspects:
- DOM Tree
- CSS Styling
Expand All @@ -41,13 +43,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 [visible][], [included in the accessibility tree][], and is either on the page or linked.
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).
- 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

Expand All @@ -69,7 +72,7 @@ There are no accessibility support issues known.

#### Passed Example 1

A video element with a text transcript on the same page.
A video element with a visible text transcript on the same page.

```html
<html lang="en">`
Expand Down Expand Up @@ -97,6 +100,22 @@ 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>
```

### Failed

#### Failed Example 1
Expand Down Expand Up @@ -129,6 +148,20 @@ 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
Comment on lines +151 to +153
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
#### 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
#### 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

<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 +164
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This collides with the changes made in #2064.

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for catching that. Requested more details in #2186

Copy link
Collaborator

@kengdoj kengdoj May 29, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This PR is removing "included in the accessibility tree" from the expectation. This will be a passed example since a transcript is available.

#2186 (comment)

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This PR is the correct direction. We remove the change from 2064. AG decided that transcripts aren't strictly required to be visible.

### Inapplicable

#### Inapplicable Example 1
Expand Down
Loading