实时区域:aria-live、aria-atomic、aria-relevant
向辅助技术播报异步更新
实时区域:aria-live、aria-atomic、aria-relevant 是 CoddyKit 上的免费 HTML Academy 课时。 这是第 3 节课,共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 HTML Academy 学习路径的一部分,你的进度在网页和 CoddyKit 应用中同步。 HTML Academy 课程共包含 4 节课。
什么是实时区域?
实时区域是页面中内容会动态更新的部分。屏幕阅读器会监测实时区域,并在内容发生更改时自动播报,无需用户移动焦点。
创建实时区域
将 aria-live 添加到 container 元素:
<!-- Polite: announce when user is idle -->
<div aria-live="polite" id="notifications"></div>
<!-- Inject text to announce: -->
<script>
document.getElementById('notifications').textContent = '5 new messages';
// Screen reader announces: '5 new messages' when user pauses
</script>复习:aria-live 的值
aria-live 的三个级别:
off——不播报(非实时区域的默认值)polite——用户暂停说话时播报assertive——立即播报,打断当前语音
深入了解 aria-atomic
aria-atomic 控制内容发生更改时播报哪些内容:
<div aria-live="polite" aria-atomic="false"> <!-- default -->
Items in cart: <span id="count">3</span>
</div>
<!-- Only the changed span is announced: '4' -->
<div aria-live="polite" aria-atomic="true">
Items in cart: <span id="count">3</span>
</div>
<!-- The entire div is announced: 'Items in cart: 4' -->
<!-- aria-atomic="true" gives more context but is more verbose -->aria-relevant 的值
aria-relevant 指定哪些 DOM 更改会触发播报:
<!-- Default: additions text -->
<div aria-live="polite" aria-relevant="additions text">
<!-- Announce removals too: -->
<div aria-live="polite" aria-relevant="removals">
<!-- Announce everything: -->
<div aria-live="polite" aria-relevant="all">
<!-- Values: additions, removals, text, all
'additions' = added nodes announced
'removals' = removed nodes announced
'text' = text content changes announced -->预定义的实时区域角色
某些角色会隐式设置 aria-live:
role="alert"——aria-live="assertive" + aria-atomic="true"role="status"——aria-live="polite" + aria-atomic="true"role="log"——aria-live="polite"role="timer"——aria-live="off"role="marquee"——aria-live="off"
使用实时区域表示加载状态
播报加载和完成状态:
<div role="status" aria-live="polite" aria-atomic="true" id="load-status">
<!-- empty initially -->
</div>
<script>
async function loadData() {
document.getElementById('load-status').textContent = 'Loading...';
const data = await fetchData();
renderResults(data);
document.getElementById('load-status').textContent =
`${data.length} results loaded.`;
}
</script>表单提交反馈
用于表示表单提交状态的实时区域:
<form id="contact-form" novalidate>
<input type="email" name="email">
<button type="submit">Subscribe</button>
</form>
<div role="status" aria-live="polite" id="form-status"></div>
<script>
form.addEventListener('submit', async (e) => {
e.preventDefault();
const status = document.getElementById('form-status');
status.textContent = 'Submitting...';
await submitForm(new FormData(form));
status.textContent = 'Thank you! You are now subscribed.';
});
</script>搜索结果数量
动态播报搜索结果:
<label for="search">Search</label>
<input type="search" id="search">
<div role="status" aria-live="polite" aria-atomic="true" id="results-count"></div>
<div id="results"></div>
<script>
let debounceTimer;
search.addEventListener('input', () => {
clearTimeout(debounceTimer);
debounceTimer = setTimeout(() => {
const results = filterResults(search.value);
renderResults(results);
document.getElementById('results-count').textContent =
`${results.length} results for "${search.value}"`;
}, 300);
});
</script>实时区域反模式
避免以下实时区域错误:
- 不要创建和销毁实时区域——应使用初始内容为空的持久区域
- 不要将实时区域放在 aria-hidden 区域内
- 不要将 assertive 用于常规更新——它会造成很大干扰
- 不要过于频繁地播报更新(应限制搜索结果数量的更新频率)
测试实时区域
如何测试实时区域的播报:
- 开启 VoiceOver(Mac:Cmd+F5)或 NVDA(Windows:Ctrl+Alt+N)
- 触发更新并听取播报内容
- 验证时机:polite 会等待,assertive 会打断
- 检查 axe DevTools 是否报告实时区域问题
快速检查
哪个角色会隐式设置 aria-live="assertive" 和 aria-atomic="true"?
复习:实时区域
实时区域的要点:
aria-live="polite"——等待用户暂停aria-live="assertive"——立即打断aria-atomic="true"——播报整个区域role="alert"= assertive + atomic;role="status" = polite + atomic- 保持实时区域持久存在;先清空内容,再设置新内容
用 AI 导师学习 HTML — 免费
在浏览器中编写并运行真实代码,获得全天候 AI 导师的即时帮助,并在网页或应用中继续学习。
- 课程
- 40
- 课程
- 159
常见问题解答
「实时区域:aria-live、aria-atomic、aria-relevant」课时是免费的吗?
是的 — 「实时区域:aria-live、aria-atomic、aria-relevant」的完整文本可在网页上免费阅读。要进行交互式练习(内置代码编辑器和全天候 AI 导师)并解锁 HTML Academy 课程的其余内容,请升级到 CoddyKit PRO。 HTML Academy 课程共包含 4 节课。
「实时区域:aria-live、aria-atomic、aria-relevant」这节课中我会学到什么?
向辅助技术播报异步更新 你通过在浏览器中直接运行的动手代码来练习 HTML Academy,全天候 AI 导师会在你学习这节课的过程中回答你的问题。
学习 HTML Academy 需要有经验吗?
无需任何先前经验。CoddyKit 上的 HTML Academy 课程适合初学者到高级学习者,你可以从这里开始或从头开始,按照自己的节奏学习。 这是第 3 节课,共 4 节。
「实时区域:aria-live、aria-atomic、aria-relevant」课时需要多长时间?
大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动,所以你能稳步进步,并在网页和应用中从离开的地方继续。
我能在这节 HTML Academy 课中编写并运行代码吗?
能。每节 HTML Academy 课都包含内置代码编辑器,你可以在浏览器中直接编写并运行真实代码,并获得即时 AI 反馈 — 无需本地设置。
此课程中的所有课时
- 用于切换控件的 aria-expanded 和 aria-controls
- aria-selected 与标签页模式
- 实时区域:aria-live、aria-atomic、aria-relevant
- 使用屏幕阅读器进行测试