空状态页面需兼顾可访问性、SEO与交互扩展,应使用隐藏内容、复用容器样式,并配合role="status"和aria-live="polite"确保无障碍感知。

空状态页面不是加个提示文字就完事
HTML 本身没有“空状态”语义,<div> 里写个 <code>"暂无数据" 看似能用,但实际会卡住可访问性、SEO 和后续交互扩展。真正要解决的不是“怎么显示一句话”,而是“怎么让空状态在 DOM、样式、逻辑、辅助技术中都成立”。
用 <template></template> 隐藏真实空内容,别用 display: none
直接对空容器设 display: none 会让屏幕阅读器跳过整个区域,用户可能根本不知道“这里本该有列表”。更糟的是,JS 后续想 show/hide 时还要反复操作样式。
- 把空状态结构放进
<template id="empty-state"></template>,它天然不渲染、不被读取、不参与流式布局 - JS 检测到数据为空时,用
content.cloneNode(true)插入目标容器,而非innerHTML = "..."—— 避免 XSS 和事件绑定丢失 - 若服务端已知为空(如 API 返回
{ data: [] }),可提前注入<template></template>内容,减少客户端 JS 判断负担
aria-live="polite" + role="status" 让空提示可感知
用户刷新后看到空白再看到提示,中间有延迟。光靠视觉提示不够,尤其对键盘或读屏用户。
- 空状态容器加上
role="status"和aria-live="polite",屏幕阅读器会在内容插入后自动播报 - 避免用
aria-live="assertive"—— 它会中断当前语音,造成干扰 - 不要只给提示文字加
aria-label:它不会触发播报,且脱离上下文后语义断裂 - 示例结构:
<div role="status" aria-live="polite"><p>暂无订单记录</p><p><span>立即学习</span>“<a href="https://pan.quark.cn/s/cb6835dc7db1" style="text-decoration: underline !important; color: blue; font-weight: bolder;" rel="nofollow" target="_blank">前端免费学习笔记(深入)</a>”;</p></div>
空状态样式必须和真实内容容器保持盒模型一致
常见错误是空状态用 <div class="empty"> 单独写一套 margin/padding,结果数据加载后高度突变、页面抖动,或者在 flex/grid 布局中错位。
<ul>
<li>空状态容器应复用真实内容容器的 class(如 <code>list-container),仅通过子元素差异区分状态
:has(:empty) 或 JS 添加 is-empty 类来切换内部文案/图标,而非替换整个容器grid-template-columns: repeat(auto-fill, minmax(240px, 1fr)),空状态容器也得撑满同样网格轨道,否则响应式断层<template></template> 使用和 aria-live 的配合里。



















