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

Editorials to 'audio has alternative' rules #1808

Merged
merged 7 commits into from
Apr 5, 2022
16 changes: 8 additions & 8 deletions _rules/audio-as-media-alternative-afb423.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ id: afb423
name: '`audio` element content is media alternative for text'
rule_type: atomic
description: |
This rule checks `audio` is a media alternative for text on the page.
This rule checks that the `audio` element is a media alternative for text on the page.
accessibility_requirements:
input_aspects:
- DOM Tree
Expand Down Expand Up @@ -59,7 +59,7 @@ There are no major accessibility support issues known for this rule.

#### Passed Example 1

An audio element that describes some of the text on the same page. The text on the page labels the audio as an alternative.
This `audio` element describes some of the text on the same page. The text on the page labels the audio as an alternative.

```html
<html lang="en">
Expand All @@ -80,7 +80,7 @@ An audio element that describes some of the text on the same page. The text on t

#### Failed Example 1

An audio element that describes some of the text on the same page. The audio contains more information than the text does.
This `audio` element describes some of the text on the same page. The audio contains more information than the text does.

```html
<html lang="en">
Expand All @@ -97,7 +97,7 @@ An audio element that describes some of the text on the same page. The audio con

#### Failed Example 2

An audio element that describes some of the text on the same page. The text is not [visible][] on the page.
This `audio` element describes some of the text on the same page. The text is not [visible][] on the page.

```html
<html lang="en">
Expand All @@ -116,7 +116,7 @@ An audio element that describes some of the text on the same page. The text is n

#### Failed Example 3

An audio element that describes some of the text on the same page. The text on the page does not label the audio as an alternative.
This `audio` element describes some of the text on the same page. The text on the page does not label the audio as an alternative.

```html
<html lang="en">
Expand All @@ -132,7 +132,7 @@ An audio element that describes some of the text on the same page. The text on t

#### Failed Example 4

An audio element that describes some of the text on the same page. The text on the page labels the audio as an alternative but the label is not [visible][] on the page.
This `audio` element describes some of the text on the same page. The text on the page labels the audio as an alternative but the label is not [visible][] on the page.

```html
<html lang="en">
Expand All @@ -153,7 +153,7 @@ An audio element that describes some of the text on the same page. The text on t

#### Inapplicable Example 1

An audio element that describes some of the text on the same page. The text on the page labels the audio as an alternative but the controls are not [visible][] on the page.
This `audio` element describes some of the text on the same page. The text on the page labels the audio as an alternative but the controls are not [visible][] on the page.

```html
<html lang="en">
Expand All @@ -172,7 +172,7 @@ An audio element that describes some of the text on the same page. The text on t

#### Inapplicable Example 2

An audio element that describes some of the text on the same page. The text on the page labels the audio as an alternative but there are no controls.
This `audio` element describes some of the text on the same page. The text on the page labels the audio as an alternative but there are no controls.

```html
<html lang="en">
Expand Down
14 changes: 7 additions & 7 deletions _rules/audio-text-alternative-e7aa44.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ id: e7aa44
name: '`audio` element content has text alternative'
rule_type: composite
description: |
This rule checks if audio only elements have a text alternative available.
This rule checks that `audio` elements have a text alternative available.
accessibility_requirements:
wcag20:1.2.1: # Audio-only and Video-only (Prerecorded) (A)
forConformance: true
Expand Down Expand Up @@ -67,7 +67,7 @@ There are no major accessibility support issues known for this rule.

#### Passed Example 1

Audio with controls and internal transcript
This `audio` element has native player controls and an internal transcript.

```html
<html lang="en">
Expand All @@ -83,7 +83,7 @@ Audio with controls and internal transcript

#### Passed Example 2

An audio element that describes some of the text on the same page. The text on the page labels the audio as an alternative.
This `audio` element describes some of the text on the same page. The text on the page labels the audio as an alternative.

```html
<html lang="en">
Expand All @@ -104,7 +104,7 @@ An audio element that describes some of the text on the same page. The text on t

#### Failed Example 1

Audio with controls and incorrect internal transcript
This `audio` element has native player controls but has an incorrect internal transcript.

```html
<html lang="en">
Expand All @@ -120,7 +120,7 @@ Audio with controls and incorrect internal transcript

#### Failed Example 2

An audio element that describes some of the text on the same page. The text is not [visible][] on the page.
This `audio` element describes some of the text on the same page. The text is not [visible][] on the page.

```html
<html lang="en">
Expand All @@ -141,7 +141,7 @@ An audio element that describes some of the text on the same page. The text is n

#### Inapplicable Example 1

Audio without controls.
This `audio` element does not have native player controls.

```html
<html lang="en">
Expand All @@ -151,7 +151,7 @@ Audio without controls.

#### Inapplicable Example 2

An audio element that describes some of the text on the same page. The text on the page labels the audio as an alternative but the controls are not [visible][] on the page.
This `audio` element describes some of the text on the same page. The text on the page labels the audio as an alternative but the controls are not [visible][] on the page.

```html
<html lang="en">
Expand Down
24 changes: 12 additions & 12 deletions _rules/audio-transcript-2eb176.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ id: 2eb176
name: '`audio` element content has transcript'
rule_type: atomic
description: |
Non-streaming `audio` elements must have a text alternative for all included auditory information.
This rule checks that `audio` elements have a transcript that includes all auditory information.
accessibility_requirements:
input_aspects:
- DOM Tree
Expand Down Expand Up @@ -56,7 +56,7 @@ There are no major accessibility support issues known for this rule.

#### Passed Example 1

Audio with controls and internal transcript
This `audio` element has native player controls and an internal transcript.

```html
<html lang="en">
Expand All @@ -72,7 +72,7 @@ Audio with controls and internal transcript

#### Passed Example 2

Audio with controls and external transcript
This `audio` element has native player controls and an external transcript.

```html
<html lang="en">
Expand All @@ -83,7 +83,7 @@ Audio with controls and external transcript

#### Passed Example 3

Audio with autoplay and external transcript
This `audio` element has an `autoplay` attribute and an external transcript.

```html
<html lang="en">
Expand All @@ -96,7 +96,7 @@ Audio with autoplay and external transcript

#### Failed Example 1

Audio with controls and no transcript
This `audio` element has native player controls and no transcript.

```html
<html lang="en">
Expand All @@ -106,7 +106,7 @@ Audio with controls and no transcript

#### Failed Example 2

Audio with controls and incorrect internal transcript
This `audio` element has native player controls and an incorrect internal transcript.

```html
<html lang="en">
Expand All @@ -122,7 +122,7 @@ Audio with controls and incorrect internal transcript

#### Failed Example 3

Audio with controls and incorrect external transcript
This `audio` element has native player controls and an incorrect external transcript.

```html
<html lang="en">
Expand All @@ -133,7 +133,7 @@ Audio with controls and incorrect external transcript

#### Failed Example 4

Audio with autoplay and incorrect external transcript
This `audio` element has an `autoplay` attribute and an incorrect external transcript.

```html
<html lang="en">
Expand All @@ -144,7 +144,7 @@ Audio with autoplay and incorrect external transcript

#### Failed Example 5

Audio with controls and [non-visible][visible] internal transcript
This `audio` element has native player controls and a [non-visible][visible] internal transcript.

```html
<html lang="en">
Expand All @@ -160,7 +160,7 @@ Audio with controls and [non-visible][visible] internal transcript

#### Failed Example 6

Audio with controls and internal transcript that is not exposed to the accessibility tree
This `audio` element has native player controls and an internal transcript that is not exposed to the accessibility tree.

```html
<html lang="en">
Expand All @@ -178,7 +178,7 @@ Audio with controls and internal transcript that is not exposed to the accessibi

#### Inapplicable Example 1

Audio without controls.
This `audio` element has no native player controls.

```html
<html lang="en">
Expand All @@ -188,7 +188,7 @@ Audio without controls.

#### Inapplicable Example 2

Audio with hidden controls.
This `audio` element has hidden native player controls.

```html
<html lang="en">
Expand Down