空状态语义优先用但需构成逻辑区块,孤立提示用;必须添加role="status"或aria-live="polite";JS控制节点挂载卸载,CSS用display:none隐藏,结构按图标→标题→说明→按钮顺序组织。

空状态用 <div> 还是 <code><section></section>?
语义上优先选 <section></section>,但前提是它确实构成一个逻辑区块(比如“搜索结果区”“评论列表区”)。如果只是孤立提示(如表格下方一行“暂无数据”),用 <div> 更轻量、更可控。滥用 <code><section></section> 会干扰屏幕阅读器的结构感知,反而降低可访问性。
- 空状态容器必须有明确的
role="status" 或 aria-live="polite",否则动态加载后提示不会被读屏软件识别
- 不要只靠颜色区分文字(如灰色字+小字号),至少叠加图标或明确定义
aria-label
- 避免把空状态写死在 HTML 里再用 JS 显示/隐藏——容易和 SSR 渲染冲突,应由 JS 控制整个节点的挂载与卸载
display: none 和 visibility: hidden 哪个更适合隐藏空状态?
用 display: none。空状态不是“暂时不可见”,而是“当前上下文不存在该内容”,visibility: hidden 仍占布局空间、仍可被聚焦、仍可能被键盘导航到,对键盘用户和读屏器都不友好。
- 如果空状态里有按钮(如“去添加”),确保它在
display: none 时完全脱离渲染流,不响应任何交互
- 切忌用
opacity: 0 + pointer-events: none 模拟隐藏——它仍参与无障碍树,且动画过渡可能暴露闪现
- 在 CSS 中统一用类名控制显隐(如
.empty-state--hidden),避免内联样式干扰 JS 状态管理
服务端返回空数组,前端怎么判断才不误判?
不能只看 data.length === 0。后端可能返回 { list: [] }、{ items: null }、甚至 { data: undefined }。关键是要和接口约定一致,并在请求层做标准化处理。
- 接口文档没写清返回结构?先查响应体,用
console.log(response) 看真实值,再写判断逻辑
- 推荐在请求封装层统一 normalize:把各种空形态转成统一的
items: [],空状态组件只认这个字段
- 特别注意分页接口:空数据 ≠
total === 0,可能是 current_page > last_page,此时应提示“已到底部”,而非“暂无内容”
图标 + 文字 + 操作按钮,DOM 结构怎么排最稳妥?
顺序必须是:图标 → 主标题 → 辅助说明文字 → 操作按钮。这是读屏器自然朗读顺序,也是视觉动线最顺的排列。用 Flex 布局时,别用 order 打乱 DOM 顺序。
- 图标用
<svg></svg> 内联,加 aria-hidden="true";不要用字体图标(兼容性和语义都差)
- 主标题用
<h3></h3>(层级需匹配父容器),辅助说明用 <p></p><div class="aritcle_card flexRow">
<div class="artcardd flexRow">
<a class="aritcle_card_img" href="/xiazai/skill12116" title="DeepBI DHTML 页面生成器"><img
src="https://img.php.cn/upload/skill/001/246/273/6adaf20d3191a227.jpg" alt="DeepBI DHTML 页面生成器" ></a>
<div class="aritcle_card_info flexColumn">
<a href="/xiazai/skill12116" title="DeepBI DHTML 页面生成器">DeepBI DHTML 页面生成器</a>
<p>生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面,使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力:
- 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面;
- 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”;
- 提及位于 `apps/console/src/featur</p>
</div>
<a href="/xiazai/skill12116" title="DeepBI DHTML 页面生成器" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span> </a>
</div>
</div>,按钮用 <button></button>(别用 <a></a> 冒充)
- 按钮文案别写“点击这里”,写具体动作,如“新建项目”“上传文件”——否则读屏器念出来毫无上下文
role="status" 或 aria-live="polite",否则动态加载后提示不会被读屏软件识别 aria-label display: none 和 visibility: hidden 哪个更适合隐藏空状态?
用 display: none。空状态不是“暂时不可见”,而是“当前上下文不存在该内容”,visibility: hidden 仍占布局空间、仍可被聚焦、仍可能被键盘导航到,对键盘用户和读屏器都不友好。
- 如果空状态里有按钮(如“去添加”),确保它在
display: none时完全脱离渲染流,不响应任何交互 - 切忌用
opacity: 0+pointer-events: none模拟隐藏——它仍参与无障碍树,且动画过渡可能暴露闪现 - 在 CSS 中统一用类名控制显隐(如
.empty-state--hidden),避免内联样式干扰 JS 状态管理
服务端返回空数组,前端怎么判断才不误判?
不能只看 data.length === 0。后端可能返回 { list: [] }、{ items: null }、甚至 { data: undefined }。关键是要和接口约定一致,并在请求层做标准化处理。
- 接口文档没写清返回结构?先查响应体,用
console.log(response) 看真实值,再写判断逻辑
- 推荐在请求封装层统一 normalize:把各种空形态转成统一的
items: [],空状态组件只认这个字段
- 特别注意分页接口:空数据 ≠
total === 0,可能是 current_page > last_page,此时应提示“已到底部”,而非“暂无内容”
图标 + 文字 + 操作按钮,DOM 结构怎么排最稳妥?
顺序必须是:图标 → 主标题 → 辅助说明文字 → 操作按钮。这是读屏器自然朗读顺序,也是视觉动线最顺的排列。用 Flex 布局时,别用 order 打乱 DOM 顺序。
- 图标用
<svg></svg> 内联,加 aria-hidden="true";不要用字体图标(兼容性和语义都差)
- 主标题用
<h3></h3>(层级需匹配父容器),辅助说明用 <p></p><div class="aritcle_card flexRow">
<div class="artcardd flexRow">
<a class="aritcle_card_img" href="/xiazai/skill12116" title="DeepBI DHTML 页面生成器"><img
src="https://img.php.cn/upload/skill/001/246/273/6adaf20d3191a227.jpg" alt="DeepBI DHTML 页面生成器" ></a>
<div class="aritcle_card_info flexColumn">
<a href="/xiazai/skill12116" title="DeepBI DHTML 页面生成器">DeepBI DHTML 页面生成器</a>
<p>生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面,使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力:
- 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面;
- 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”;
- 提及位于 `apps/console/src/featur</p>
</div>
<a href="/xiazai/skill12116" title="DeepBI DHTML 页面生成器" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span> </a>
</div>
</div>,按钮用 <button></button>(别用 <a></a> 冒充)
- 按钮文案别写“点击这里”,写具体动作,如“新建项目”“上传文件”——否则读屏器念出来毫无上下文
console.log(response) 看真实值,再写判断逻辑 items: [],空状态组件只认这个字段 total === 0,可能是 current_page > last_page,此时应提示“已到底部”,而非“暂无内容” order 打乱 DOM 顺序。
- 图标用
<svg></svg>内联,加aria-hidden="true";不要用字体图标(兼容性和语义都差) - 主标题用
<h3></h3>(层级需匹配父容器),辅助说明用<p></p><div class="aritcle_card flexRow"> <div class="artcardd flexRow"> <a class="aritcle_card_img" href="/xiazai/skill12116" title="DeepBI DHTML 页面生成器"><img src="https://img.php.cn/upload/skill/001/246/273/6adaf20d3191a227.jpg" alt="DeepBI DHTML 页面生成器" ></a> <div class="aritcle_card_info flexColumn"> <a href="/xiazai/skill12116" title="DeepBI DHTML 页面生成器">DeepBI DHTML 页面生成器</a> <p>生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面,使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力: - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面; - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”; - 提及位于 `apps/console/src/featur</p> </div> <a href="/xiazai/skill12116" title="DeepBI DHTML 页面生成器" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span> </a> </div> </div>,按钮用<button></button>(别用<a></a>冒充) - 按钮文案别写“点击这里”,写具体动作,如“新建项目”“上传文件”——否则读屏器念出来毫无上下文
空状态不是“补丁”,它是数据流断裂时的第一道反馈。很多人卡在“显示了但读不到”“点了没反应”“换主题后文字看不见”,问题往往出在语义缺失、状态不同步、或者把样式当逻辑用。


















