动态内容更新必须在DOM初始加载时声明aria-live容器，后期JS添加属性或元素无效；需服务端或模板中预置，用textContent更新纯文本，依中断性选polite或assertive，并避免立即清空。
动态内容更新必须在 DOM 初始加载时就声明 aria-live 容器，否则屏幕阅读器根本不会监听它——后期用 JS 添加属性或插入元素都无效。
aria-live 元素必须在 HTML 首次渲染时存在
绝大多数屏幕阅读器（NVDA、JAWS、VoiceOver）只在元素挂载进 DOM 的瞬间解析 aria-live 属性。如果靠 JS 动态创建并设置：el.setAttribute('aria-live', 'polite')，该区域将完全静音。
- ✅ 正确做法：把容器写死在服务端 HTML 或前端模板的
开头，例如：
<div id="live-region" aria-live="polite" aria-atomic="true" class="sr-only"></div>
- ❌ 常见错误：在
DOMContentLoaded里用document.createElement创建再 append；或初始 HTML 中漏掉该元素，等表单提交后再注入 - ⚠️ 注意：
.sr-only类不能是display: none或visibility: hidden，否则通知失效；应使用 clip + absolute 定位隐藏
textContent 更新比 innerHTML 更安全可靠
往 aria-live 区域写入含 HTML 标签的字符串（如 el.innerHTML = "<strong>成功</strong>"），会导致部分读屏软件跳过标签、朗读断裂，甚至彻底不播报。
- ✅ 推荐只用
textContent更新纯文本内容，例如：document.getElementById('live-region').textContent = '密码已重置成功' - ❌ 避免在
aria-live区域内频繁增删子节点；也不要用innerHTML插入图标、<span></span>等装饰性结构 - ? 如果真需强调文字（如“失败”加粗），改用 CSS 视觉样式，而非 HTML 标签——语义和可访问性由
aria-live和文本本身承载
polite 与 assertive 的选择取决于中断性
aria-live="polite" 和 aria-live="assertive" 不是“语气强弱”的区别，而是播报时机和行为逻辑的根本不同。
把任意文章或文档内容转换成精美的全屏翻页 HTML 演示文件（幻灯片风格）。当用户发来一篇文章、文档链接、Markdown 内容、或粘贴的文本，并且希望生成演示用的 HTML 时触发。支持任意内容来源：iWiki 链接、KM 链接、本地文件路径、直接粘贴的文本。生成的 HTML 文件保存到本地工作区，并通过企微直接发送给用户。触发词示例：帮我把这篇文章做成PPT、转成演示文档、生成HTML幻灯片、做个演示、转成可以演示的格式、article to deck、make a slide。
立即学习“前端免费学习笔记（深入）”；
- ✅
aria-live="polite"：适合状态类消息（“已保存”“加载完成”），等待用户当前操作暂停后播报；配合role="status"更明确 - ✅
aria-live="assertive"：仅用于必须立即打断用户操作的关键信息（“登录失败”“网络断开”），会中止当前朗读；role="alert"是其语义等价写法 - ⚠️ 别滥用
assertive：连续触发两次以上，可能让屏幕阅读器卡住或跳过后续播报；一次只播一条，且确保内容完整、无歧义
DOM 插入后不要立刻清空内容
很多开发者习惯在播报后马上清空 aria-live 区域，比如 el.textContent = ''; el.textContent = '新消息';。这会造成内容“闪现即逝”，屏幕阅读器来不及捕获。
- ✅ 正确节奏：先设新文本 → 等待至少 100ms → 再清空（如有需要）。更稳妥的做法是每次只覆盖，不主动清空
- ❌ 错误模式：在同一个事件循环中反复赋值
textContent，或用el.innerHTML = ''后立即重写，容易导致播报丢失 - ? 补充：若需支持多条消息队列，不要复用一个
aria-live区域轮播；应设计为单次播报后保持内容可见几秒，再由 JS 移除——移除动作本身不会触发播报
最容易被忽略的是：即使写了 aria-live，如果容器在初始 HTML 里没出现、或者用了 display: none、或者用 innerHTML 注入带标签的内容，整个通知链就断了。可访问性不是加个属性就完事，而是从 HTML 结构、JS 更新方式到视觉隐藏策略的全链路对齐。
