Skip to Content

配置条件数据

在开发应用时,我们经常需要根据不同的场景动态地展示不同的内容。例如:用户登录后展示“欢迎回来”,未登录时提示“请登录”。

Zion 提供了 “条件数据” 功能。它允许您在不编写代码的情况下,为组件属性、样式或行为参数配置多条分支条件,自上而下匹配并动态输出对应的数据值。


1. 条件分支的匹配规则

条件数据的底层运行逻辑非常严谨,它遵循以下三项核心规则:

  1. 自上而下,顺序匹配:系统在运行时,会从最上方的第一个分支条件开始向下逐一判断。
  2. 命中即中断:一旦某个分支条件判定为真(true),系统会立即输出该分支绑定的数据,并直接退出当前判定链,不再继续往下计算。
  3. 必须以“总是”分支兜底:为了防止所有条件都为假(false)时导致页面渲染空白或出错,条件分支配置必须以“总是”作为最后一个兜底分支(相当于传统代码中的 else 默认分支)。

2. 配置条件数据步骤

以下以根据“用户是否登录”展示不同欢迎文案为例,带您掌握完整的配置流程:

开启条件数据

  1. 选中画布中的目标组件(如:展示欢迎词的文本组件)。
  2. 在右侧属性面板的对应输入框(如“文本内容”)旁,点击开启 “条件数据” 图标。
  3. 界面会展开条件分支配置面板。

条件数据示意图

增加条件分支并编写判断条件

  1. 点击“添加分支”创建新的判断条件(如分支一命名为 已登录状态)。
  2. 在该分支的条件输入框中,绑定您的逻辑表达式(例如绑定为:当前用户.是否登录 = true)。
  3. 在其对应的数据输入框中,填入或绑定要输出的欢迎内容:"欢迎回来!"

配置最后的“总是”分支

  1. 在条件链的末尾,配置一个 “总是” 分支(代表前面所有条件都不满足时的默认状态,即未登录状态)。
  2. 在其对应的数据输入框中,填入要展示的兜底内容:"请登录以体验更多功能。"

重新预览测试

  1. 点击预览项目。
  2. 切换不同的登录状态,观察文本组件是否能够根据设定的条件,实现文字内容的动态平滑切换。

3. 实践避坑建议

⚠️
  • 注意分支排序:由于条件是自上而下顺序匹配的,特异性最高、判定范围最窄的条件必须放在最上面;范围最宽的条件放在下面。例如,如果您要判定“黄金会员”、“普通会员”和“普通用户”,请务必将“黄金会员”排在最上面。若把“普通用户”放在最上面,黄金会员也会直接命中普通用户分支并退出,导致逻辑失效。
  • 空值比较处理:在过滤或条件中,如果直接将变量与空值进行等值比较,可能会由于空值特性导致判定为真。建议使用公式或条件分支提前做非空校验。
Last updated on