配置条件数据
在开发应用时,我们经常需要根据不同的场景动态地展示不同的内容。例如:用户登录后展示“欢迎回来”,未登录时提示“请登录”。
Zion 提供了 “条件数据” 功能。它允许您在不编写代码的情况下,为组件属性、样式或行为参数配置多条分支条件,自上而下匹配并动态输出对应的数据值。
1. 条件分支的匹配规则
条件数据的底层运行逻辑非常严谨,它遵循以下三项核心规则:
- 自上而下,顺序匹配:系统在运行时,会从最上方的第一个分支条件开始向下逐一判断。
- 命中即中断:一旦某个分支条件判定为真(
true),系统会立即输出该分支绑定的数据,并直接退出当前判定链,不再继续往下计算。 - 必须以“总是”分支兜底:为了防止所有条件都为假(
false)时导致页面渲染空白或出错,条件分支配置必须以“总是”作为最后一个兜底分支(相当于传统代码中的else默认分支)。
2. 配置条件数据步骤
以下以根据“用户是否登录”展示不同欢迎文案为例,带您掌握完整的配置流程:
开启条件数据
- 选中画布中的目标组件(如:展示欢迎词的文本组件)。
- 在右侧属性面板的对应输入框(如“文本内容”)旁,点击开启 “条件数据” 图标。
- 界面会展开条件分支配置面板。

增加条件分支并编写判断条件
- 点击“添加分支”创建新的判断条件(如分支一命名为
已登录状态)。 - 在该分支的条件输入框中,绑定您的逻辑表达式(例如绑定为:
当前用户.是否登录 = true)。 - 在其对应的数据输入框中,填入或绑定要输出的欢迎内容:
"欢迎回来!"。
配置最后的“总是”分支
- 在条件链的末尾,配置一个 “总是” 分支(代表前面所有条件都不满足时的默认状态,即未登录状态)。
- 在其对应的数据输入框中,填入要展示的兜底内容:
"请登录以体验更多功能。"。
重新预览测试
- 点击预览项目。
- 切换不同的登录状态,观察文本组件是否能够根据设定的条件,实现文字内容的动态平滑切换。
3. 实践避坑建议
⚠️
- 注意分支排序:由于条件是自上而下顺序匹配的,特异性最高、判定范围最窄的条件必须放在最上面;范围最宽的条件放在下面。例如,如果您要判定“黄金会员”、“普通会员”和“普通用户”,请务必将“黄金会员”排在最上面。若把“普通用户”放在最上面,黄金会员也会直接命中普通用户分支并退出,导致逻辑失效。
- 空值比较处理:在过滤或条件中,如果直接将变量与空值进行等值比较,可能会由于空值特性导致判定为真。建议使用公式或条件分支提前做非空校验。
Last updated on