Skip to Content

配置条件数据

条件数据可以根据运行时条件为同一配置项提供不同的值。例如,用户登录后显示“欢迎回来”,未登录时显示“请登录”。

条件数据可用于组件属性、样式和行为参数。系统从上到下判断分支,并返回第一个匹配分支的值。

条件分支的匹配规则

  1. 从上到下匹配:系统从第一个分支开始依次判断。
  2. 返回第一个匹配结果:分支条件为 true 时返回该分支的值,不再判断后续分支。
  3. 使用“总是”兜底:建议把“总是”放在最后,为其他条件都不满足的情况提供默认值。
  4. 没有分支命中时结果为 null:所有分支的条件都不成立时,返回 null。

所有分支都不命中时

没有任何分支的条件成立时,这个配置项取空值。系统不会报错,也不会保留上一次的值,因此绑定了条件数据的文本会变成空白、图片会不显示。

⚠️

数据源的筛选条件不会出现这种情况:它的分支列表以恒成立的 Default(默认)分支结尾,总有一条筛选生效。请保持 Default 分支在最后,把它排到前面会短路它后面的所有分支。

空值在各处的完整表现见空值规则。

配置条件数据

以下示例根据登录状态显示不同文案:

开启条件数据

  1. 选中用于显示欢迎词的文本组件。
  2. 在右侧属性面板的文本内容旁开启条件数据。
  3. 界面会展开条件分支配置面板。

条件数据示意图

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

  1. 添加一个名为“已登录”的分支。
  2. 将条件绑定为“是否登录 = true”。
  3. 将分支值设置为“欢迎回来!”。

配置最后的“总是”分支

  1. 在条件链末尾添加总是分支。
  2. 将分支值设置为“请登录”。

重新预览测试

  1. 打开预览。
  2. 分别以登录和未登录状态访问页面,确认文本正确切换。

注意事项

⚠️
  • 分支排序:把范围更窄的条件放在前面。例如,“黄金会员”应放在“普通用户”之前。
  • 空值处理:没有分支命中时得到的 null 会照常传给下游:绑定在 API 输入、请求体字段或行为流入参上时,下游收到的是 null。
  • 相关规则:数据源过滤中的空值见获取数据源与数据绑定;API 请求参数的空值见集成第三方 API;行为流入参的空值见搭建行为流。
Last updated on