Skip to content

Commit d06b0bf

Browse files
cookiecrookpkra
authored andcommitted
initial draft for #1216
1 parent bf8e158 commit d06b0bf

File tree

1 file changed

+6
-5
lines changed

1 file changed

+6
-5
lines changed

index.html

+6-5
Original file line numberDiff line numberDiff line change
@@ -1479,6 +1479,7 @@ <h3>Landmark Roles</h3>
14791479
<section id="live_region_roles">
14801480
<h3>Live Region Roles</h3>
14811481
<p>The following <a>roles</a> are <a>live regions</a> and can be modified by <a href="#attrs_liveregions">live region attributes</a>.</p>
1482+
<p>Typically, assistive technology only speaks <em>changes</em> to a live region, not the initial contents of a live region. To ensure content in a live region is announced, authors SHOULD create an rendered but empty live region as early as possible (such as on page load), and then add content to the live region when the author wishes it to be announced. The exception to this live region convention is <code>alert</code>, due to system accessiblity notifications events required for the role. While an <rref>alert</rref> is a live region, its content is announced by assistive technology when the alert is rendered on the page and when the content changes.</p>
14821483
<ul>
14831484
<li><rref>alert</rref></li>
14841485
<li><rref>log</rref></li>
@@ -1506,13 +1507,10 @@ <h2>Definition of Roles</h2>
15061507
<div class="role-description">
15071508
<p>A type of <a>live region</a> with important, and usually time-sensitive, information. See related <rref>alertdialog</rref> and <rref>status</rref>.</p>
15081509
<p>
1509-
Alerts are used to convey messages that might be immediately important to users. In the case of audio warnings, alerts provide an accessible alternative for hearing-impaired users. The
1510-
<code>alert</code> <a>role</a> is applied to the element containing the alert message. An <code>alert</code> is a specialized form of the <rref>status</rref> role, which is processed as
1511-
an atomic <a>live region</a>.
1510+
Alerts are used to convey messages that will be immediately important to users. In the case of audio warnings, alerts provide an accessible alternative for Deaf or hard-of-hearing users. The <code>alert</code> <a>role</a> is applied to the element containing the alert message.
15121511
</p>
15131512
<p>
1514-
Alerts are assertive live regions, which means they cause immediate notification for assistive technology users. If the operating system allows, the <a>user agent</a> SHOULD fire a
1515-
system alert <a>event</a> through the accessibility API when the <abbr title="Accessible Rich Internet Applications">WAI-ARIA</abbr> alert is created.
1513+
Alert is a special type of assertive live region that is intended to cause immediate notification for assistive technology users. If the operating system allows, the <a>user agent</a> SHOULD fire a system alert <a>event</a> through the accessibility API when the alert is rendered.
15161514
</p>
15171515
<p>
15181516
Neither authors nor user agents are required to set or manage focus to an alert in order for it to be processed. Since alerts are not required to receive focus, authors SHOULD NOT
@@ -1612,6 +1610,9 @@ <h2>Definition of Roles</h2>
16121610
dialog. Authors SHOULD make alert dialogs modal by ensuring that, while the <code>alertdialog</code> is shown, keyboard and mouse interactions only operate within the dialog. See
16131611
<pref>aria-modal</pref>.
16141612
</p>
1613+
<p>
1614+
Alertdialog is a special type of dialog that is intended to cause an immediate, alert-level notification for assistive technology users. If the operating system allows, the <a>user agent</a> SHOULD fire a system alert <a>event</a> through the accessibility API when the alerdialog is rendered.
1615+
</p>
16151616
<p>
16161617
Unlike <rref>alert</rref>, <code>alertdialog</code> can receive a response from the user. For example, to confirm that the user understands the alert being generated. When the alert
16171618
dialog is displayed, authors SHOULD set focus to an active element within the alert dialog, such as a form control or confirmation button. The <a>user agent</a> SHOULD fire a system

0 commit comments

Comments
 (0)