Skip to content

Commit 73716a2

Browse files
daniel-montalvokengdojJym77
authored
Editorials to 'audio has alternative' rules (#1808)
* Editorials to 'audio has alternative' rules * Update _rules/audio-text-alternative-e7aa44.md Co-authored-by: Kathy Eng <kengdoj@users.noreply.github.com> Co-authored-by: Kathy Eng <kengdoj@users.noreply.github.com> Co-authored-by: Jean-Yves Moyen <jym@siteimprove.com>
1 parent 25d868f commit 73716a2

3 files changed

Lines changed: 27 additions & 27 deletions

File tree

‎_rules/audio-as-media-alternative-afb423.md‎

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ id: afb423
33
name: '`audio` element content is media alternative for text'
44
rule_type: atomic
55
description: |
6-
This rule checks `audio` is a media alternative for text on the page.
6+
This rule checks that the `audio` element is a media alternative for text on the page.
77
accessibility_requirements:
88
input_aspects:
99
- DOM Tree
@@ -59,7 +59,7 @@ There are no major accessibility support issues known for this rule.
5959

6060
#### Passed Example 1
6161

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

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

8181
#### Failed Example 1
8282

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

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

9898
#### Failed Example 2
9999

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

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

117117
#### Failed Example 3
118118

119-
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.
119+
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.
120120

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

133133
#### Failed Example 4
134134

135-
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.
135+
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.
136136

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

154154
#### Inapplicable Example 1
155155

156-
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.
156+
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.
157157

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

173173
#### Inapplicable Example 2
174174

175-
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.
175+
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.
176176

177177
```html
178178
<html lang="en">

‎_rules/audio-text-alternative-e7aa44.md‎

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ id: e7aa44
33
name: '`audio` element content has text alternative'
44
rule_type: composite
55
description: |
6-
This rule checks if audio only elements have a text alternative available.
6+
This rule checks that `audio` elements have a text alternative available.
77
accessibility_requirements:
88
wcag20:1.2.1: # Audio-only and Video-only (Prerecorded) (A)
99
forConformance: true
@@ -67,7 +67,7 @@ There are no major accessibility support issues known for this rule.
6767

6868
#### Passed Example 1
6969

70-
Audio with controls and internal transcript
70+
This `audio` element has native player controls and an internal transcript.
7171

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

8484
#### Passed Example 2
8585

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

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

105105
#### Failed Example 1
106106

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

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

121121
#### Failed Example 2
122122

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

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

142142
#### Inapplicable Example 1
143143

144-
Audio without controls.
144+
This `audio` element does not have native player controls.
145145

146146
```html
147147
<html lang="en">
@@ -151,7 +151,7 @@ Audio without controls.
151151

152152
#### Inapplicable Example 2
153153

154-
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.
154+
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.
155155

156156
```html
157157
<html lang="en">

‎_rules/audio-transcript-2eb176.md‎

Lines changed: 12 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ id: 2eb176
33
name: '`audio` element content has transcript'
44
rule_type: atomic
55
description: |
6-
Non-streaming `audio` elements must have a text alternative for all included auditory information.
6+
This rule checks that `audio` elements have a transcript that includes all auditory information.
77
accessibility_requirements:
88
input_aspects:
99
- DOM Tree
@@ -56,7 +56,7 @@ There are no major accessibility support issues known for this rule.
5656

5757
#### Passed Example 1
5858

59-
Audio with controls and internal transcript
59+
This `audio` element has native player controls and an internal transcript.
6060

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

7373
#### Passed Example 2
7474

75-
Audio with controls and external transcript
75+
This `audio` element has native player controls and an external transcript.
7676

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

8484
#### Passed Example 3
8585

86-
Audio with autoplay and external transcript
86+
This `audio` element has an `autoplay` attribute and an external transcript.
8787

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

9797
#### Failed Example 1
9898

99-
Audio with controls and no transcript
99+
This `audio` element has native player controls and no transcript.
100100

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

107107
#### Failed Example 2
108108

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

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

123123
#### Failed Example 3
124124

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

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

134134
#### Failed Example 4
135135

136-
Audio with autoplay and incorrect external transcript
136+
This `audio` element has an `autoplay` attribute and an incorrect external transcript.
137137

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

145145
#### Failed Example 5
146146

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

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

161161
#### Failed Example 6
162162

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

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

179179
#### Inapplicable Example 1
180180

181-
Audio without controls.
181+
This `audio` element has no native player controls.
182182

183183
```html
184184
<html lang="en">
@@ -188,7 +188,7 @@ Audio without controls.
188188

189189
#### Inapplicable Example 2
190190

191-
Audio with hidden controls.
191+
This `audio` element has hidden native player controls.
192192

193193
```html
194194
<html lang="en">

0 commit comments

Comments
 (0)