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

空状态用 还是 ?
语义上优先选 ,但前提是它确实构成一个逻辑区块(比如“搜索结果区”“评论列表区”)。如果只是孤立提示(如表格下方一行“暂无数据”),用 更轻量、更可控。滥用 会干扰屏幕阅读器的结构感知,反而降低可访问性。
- 空状态容器必须有明确的
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 顺序。
空状态不是“补丁”,它是数据流断裂时的第一道反馈。很多人卡在“显示了但读不到”“点了没反应”“换主题后文字看不见”,问题往往出在语义缺失、状态不同步、或者把样式当逻辑用。
DeepBI DHTML 页面生成器
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面,使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力:
- 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面;
- 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”;
- 提及位于 `apps/console/src/featur
下载
?
语义上优先选 ,但前提是它确实构成一个逻辑区块(比如“搜索结果区”“评论列表区”)。如果只是孤立提示(如表格下方一行“暂无数据”),用 更轻量、更可控。滥用 会干扰屏幕阅读器的结构感知,反而降低可访问性。
- 空状态容器必须有明确的
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 顺序。
空状态不是“补丁”,它是数据流断裂时的第一道反馈。很多人卡在“显示了但读不到”“点了没反应”“换主题后文字看不见”,问题往往出在语义缺失、状态不同步、或者把样式当逻辑用。
DeepBI DHTML 页面生成器
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面,使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力:
- 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面;
- 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”;
- 提及位于 `apps/console/src/featur
下载
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










