-
Notifications
You must be signed in to change notification settings - Fork 21
/
Copy pathinput-help-text-aria-describedby.html
58 lines (58 loc) · 3 KB
/
input-help-text-aria-describedby.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>input with help text using "aria-describedby"</title>
<meta name="viewport" content="width=device-width, initial-scale=1">
<link rel="shortcut icon" href="favicon.ico">
<link href="assets/css/examples.css" rel="stylesheet">
</head>
<body>
<h1><code><input></code> with help text using <code>aria-describedby</code></h1>
<p>← <a href="index.html">Return to main list</a></p>
<p>This is a test case designed to determine how help information, associated with an <a href="https://html.spec.whatwg.org/multipage/input.html#the-input-element" target="_blank"><code><input></code></a> via the <a href="https://www.w3.org/TR/wai-aria/#aria-describedby" target="_blank"><code>aria-describedby</code></a> attribute, is announced by various screen readers.</p>
<p>The help information should be defined as a description in the accessibility tree, and not part of the accessible name. For this reason, it should be announced after the accessible name and form control information.</p>
<h2>Example</h2>
<form action="#">
<div class="form-group">
<label class="label" for="name">Name</label>
<span class="help-text" id="help-text">Make sure to include full name</span>
<input class="input" type="text" id="name" aria-describedby="help-text">
</div>
</form>
<h2>Code</h2>
<!-- start code -->
<pre><code><div>
<label for="name">Name</label>
<span id="help-text">Make sure to include full name</span>
<input type="text" id="name" aria-describedby="help-text">
</div></code></pre>
<!-- end code -->
<h2>Assistive technologies</h2>
<div class="note">
<h3>VoiceOver</h3>
<ul class="browser-list">
<li><b>Chrome:</b> Name. Edit text. [Pause] <span class="green">Make sure to include full name</span>.</li>
<li><b>Firefox:</b> Name. Edit text. [Pause] <span class="green">Make sure to include full name</span>.</li>
<li><b>Safari:</b> Name. Edit text. [Pause] <span class="green">Make sure to include full name</span>.</li>
</ul>
</div>
<div class="note">
<h3>NVDA</h3>
<ul class="browser-list">
<li><b>Chrome:</b> Name. Edit. <span class="green">Make sure to include full name</span>. Blank.</li>
<li><b>Firefox:</b> Name. Edit. Has autocomplete. <span class="green">Make sure to include full name</span>. Blank.</li>
<li><b>Edge:</b> Name. Edit. <span class="green">Make sure to include full name</span>. Blank.</li>
</ul>
</div>
<div class="note">
<h3>JAWS</h3>
<ul class="browser-list">
<li><b>Chrome:</b> Name. Edit. <span class="green">Make sure to include full name</span>. Type in text.</li>
<li><b>Firefox:</b> Name. Edit. <span class="green">Make sure to include full name</span>. Type in text.</li>
<li><b>Edge:</b> Name. Edit. <span class="green">Make sure to include full name</span>. Type in text.</li>
</ul>
</div>
<p>← <a href="index.html">Return to main list</a></p>
</body>
</html>