Zion平台列表为空时不自动显示占位文案,需手动配置;仅v2.8.3+版本支持,且仅表格组件和重复容器具备空状态配置入口,可通过可视化配置或JSON Schema注入emptyState字段实现。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

列表为空时,Zion平台默认不自动显示占位文案,必须手动配置才能触发渲染提示内容。
确认Zion版本与组件类型
进入Zion项目编辑页 → 点击左侧「数据源」→ 查看右上角平台版本号,确保为 【v2.8.3 或更高】;低版本不支持空状态钩子。若使用的是「表格组件」或「重复容器(Repeater)」,才具备空状态配置入口;普通文本框、按钮等静态组件无此能力。
在重复容器中启用空状态文案
方法一:可视化配置(推荐)
点击画布中的重复容器 → 右侧属性面板展开「空状态」选项 → 开关置为「开启」→ 在输入框中填写文案,例如“暂无订单”。这一步操作起来很简单,直接把文字敲进去就行。
方法二:JSON Schema 手动注入
切换至「代码视图」→ 找到该容器对应字段的 schema 片段 → 在其同级添加 "emptyState": {"text": "加载中…"} 字段。注意:若 schema 中已存在 "required" 或 "default",必须用英文逗号补全分隔符,否则保存会失败。
验证空状态是否生效
第一步:在数据源中临时清空全部记录,或断开真实API连接;
第二步:点击预览按钮 → 观察重复容器区域是否渲染出你填写的文案;
第三步:重新接入带数据的API,确认文案自动消失、列表正常渲染。
⚠️关键提醒:若空状态未出现,请检查数据源返回值是否为 [](空数组),而非 null 或 {items: []} —— Zion只识别顶层为数组且长度为0的情形。


















