Skip to content

Commit 334bc2f

Browse files
kengdojJym77
andauthored
Update audio-text-alternative-e7aa44.md from TF survey responses (#1828)
* Update audio-text-alternative-e7aa44.md * Update audio-text-alternative-e7aa44.md * Update _rules/audio-text-alternative-e7aa44.md Co-authored-by: Jean-Yves Moyen <jym@siteimprove.com> * Update _rules/audio-text-alternative-e7aa44.md Co-authored-by: Jean-Yves Moyen <jym@siteimprove.com> * Update audio-text-alternative-e7aa44.md * Update audio-text-alternative-e7aa44.md Co-authored-by: Jean-Yves Moyen <jym@siteimprove.com>
1 parent 01d1e1a commit 334bc2f

1 file changed

Lines changed: 29 additions & 12 deletions

File tree

_rules/audio-text-alternative-e7aa44.md

Lines changed: 29 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -32,9 +32,9 @@ acknowledgments:
3232

3333
## Applicability
3434

35-
This rule applies to any [non-streaming](#non-streaming-media-element) `audio` element that is:
35+
This rule applies to any [non-streaming](#non-streaming-media-element) `audio` element for which at least one of the following is true:
3636

37-
- playing; or,
37+
- has an `autoplay` [attribute value][] of true; or,
3838
- has a "play button" that is [visible][] and [included in the accessibility tree](#included-in-the-accessibility-tree).
3939

4040
**Note:** A play button is an interactive element that when activated, plays the audio.
@@ -67,7 +67,7 @@ There are no major accessibility support issues known for this rule.
6767

6868
#### Passed Example 1
6969

70-
This `audio` element has native player controls and an internal transcript.
70+
This `audio` element has a play button, and there is a transcript of the audio.
7171

7272
```html
7373
<html lang="en">
@@ -83,7 +83,7 @@ This `audio` element has native player controls and an internal transcript.
8383

8484
#### Passed Example 2
8585

86-
This `audio` element describes some of the text on the same page. The text on the page labels the audio as an alternative.
86+
This `audio` element has a play button, and the text on the page labels the audio as an alternative.
8787

8888
```html
8989
<html lang="en">
@@ -100,18 +100,34 @@ This `audio` element describes some of the text on the same page. The text on th
100100
</html>
101101
```
102102

103+
#### Passed Example 3
104+
105+
This `audio` element autoplays, and there is a transcript of the audio.
106+
107+
```html
108+
<html lang="en">
109+
<audio src="/test-assets/moon-audio/moon-speech.mp3" autoplay controls></audio>
110+
<p>
111+
The above audio contains the following speech: We choose to go to the moon in this decade and do the other things,
112+
not because they are easy, but because they are hard, because that goal will serve to organize and measure the best
113+
of our energies and skills, because that challenge is one that we are willing to accept, one we are unwilling to
114+
postpone, and one which we intend to win, and the others, too.
115+
</p>
116+
</html>
117+
```
118+
103119
### Failed
104120

105121
#### Failed Example 1
106122

107-
This `audio` element has native player controls but has an incorrect internal transcript.
123+
This `audio` element has a play button but has an incorrect transcript.
108124

109125
```html
110126
<html lang="en">
111127
<audio src="/test-assets/moon-audio/moon-speech.mp3" controls></audio>
112128
<p>
113-
The above audio contains the following speech: We choose to go to the cheese in this decade and do the other things,
114-
not because they are easy, but because they are hard, because that goal will serve to organize and measure the best
129+
The above audio contains the following speech: We are going to the North Pole in this decade with puppies,
130+
not because they are easy, but because they are cute, because that goal will serve to organize and measure the best
115131
of our energies and skills, because that challenge is one that we are willing to accept, one we are unwilling to
116132
postpone, and one which we intend to win, and the others, too.
117133
</p>
@@ -120,7 +136,7 @@ This `audio` element has native player controls but has an incorrect internal tr
120136

121137
#### Failed Example 2
122138

123-
This `audio` element describes some of the text on the same page. The text is not [visible][] on the page.
139+
This `audio` element autoplays but the text transcript is not [visible][] on the page.
124140

125141
```html
126142
<html lang="en">
@@ -133,15 +149,15 @@ This `audio` element describes some of the text on the same page. The text is no
133149
<p>
134150
You can also listen to the audio file below to hear the above part of the speech.
135151
</p>
136-
<audio src="/test-assets/moon-audio/moon-speech.mp3" controls></audio>
152+
<audio src="/test-assets/moon-audio/moon-speech.mp3" autoplay controls></audio>
137153
</html>
138154
```
139155

140156
### Inapplicable
141157

142158
#### Inapplicable Example 1
143159

144-
This `audio` element does not have native player controls.
160+
This `audio` element does not autoplay or have a play button.
145161

146162
```html
147163
<html lang="en">
@@ -151,7 +167,7 @@ This `audio` element does not have native player controls.
151167

152168
#### Inapplicable Example 2
153169

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.
170+
This `audio` element is labeled as an alternative by text on the same page, but the controls are not [visible][] on the page.
155171

156172
```html
157173
<html lang="en">
@@ -181,9 +197,10 @@ This `a` element links to an audio file, but there is no `audio` element on this
181197
postpone, and one which we intend to win, and the others, too.
182198
</p>
183199
<p>
184-
<a href="/test-assets/moon-audio/moon-speech.mp3">Download the speach as MP3</a>
200+
<a href="/test-assets/moon-audio/moon-speech.mp3">Download the speech as MP3</a>
185201
</p>
186202
</html>
187203
```
188204

205+
[attribute value]: #attribute-value 'Definition of Attribute Value'
189206
[visible]: #visible 'Definition of visible'

0 commit comments

Comments
 (0)