HTML Academy · 课时

实时区域:aria-live、aria-atomic、aria-relevant

向辅助技术播报异步更新

第 3 / 4 课13 个步骤

实时区域: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 反馈 — 无需本地设置。

此课程中的所有课时

  1. 用于切换控件的 aria-expanded 和 aria-controls
  2. aria-selected 与标签页模式
  3. 实时区域:aria-live、aria-atomic、aria-relevant
  4. 使用屏幕阅读器进行测试
← 返回 HTML Academy