优维低代码：Redirect 路由重定向&If 条件渲染

优维低代码技术专栏， 是一个全新的、技术为主的专栏，由优维技术委员会成员执笔，基于优维7年低代码技术研发及运维成果，主要介绍低代码相关的技术原理及架构逻辑，目的是给广大运维人提供一个技术交流与学习的平台。

• • -

    连载第三十期

    《高级指引： Redirect 路由重定向&If 条件渲染 》

    ▽

1. Redirect 路由重定向

可以为指定路由设置重定向目标，该目标可以设置为固定目标，也可以设置为一个 Resolvable 的目标（即通过类似 useResolves 的机制动态计算得到）：

# 固定目标

例如对于以下路由配置：

path: "${APP.homepage}"
exact: true
redirect: "${APP.homepage}/product"

当用户访问该应用首页时，将自动重定向到 /product 子页面去。

# Resolvable 目标

又如以下使用 Resolvable 目标的路由配置：

path: "${APP.homepage}"
exact: true
redirect:
  useProvider: "your-provider"
  transform:
    redirect: "${APP.homepage}/product/@{productId}"

当用户访问该应用首页时，系统将调用 your-provider 的 resolve 方法，将计算得到的 productId 拼装成 /product/@{productId} 作为跳转目标。

注意：当使用 Resolvable 目标时，应始终返回一个 { redirect?: string } 的对象，当返回的 redirect 属性为 falsy 值时，系统将忽略重定向，继续执行子路由的匹配或构件列表的渲染。

2. If 条件渲染

有些场景下，我们希望 Storyboard 可以根据特性开关或其它动态数据进行特定配置，例如根据用户权限决定使用哪些构件/路由。

# 普通条件

例如对于以下构件配置：

bricks:
  - if: '<% !!FLAGS["your-feature"] %>'
    brick: your-brick-a
  - if: '<% !FLAGS["your-feature"] %>'
    brick: "your-brick-b"

当特性开关 your-feature 打开时，将显示构件 your-brick-a，反之则显示 your-brick-b。

Tips: 从 brick_next: 1.27.4 开始，if 表达式不再要求必须返回 boolean 值，平台将自动做类型转换。

当使用参数注入或 transform 时，应确认最终得到一个 boolean 值，例如在求值占位符中可以使用取反运算符 !!someValue，在注入占位符中使用 | bool 或 | not，因为平台仅在识别到 if: false 时才跳过渲染。

# Resolvable 条件

当条件需要请求服务端接口或需要更复杂的逻辑计算得到时，可以使用 Resolvable 条件（类似 useResolves 的机制）：

bricks:
  - if:
      useProvider: "your-permission-provider"
      transform:
        if: "@{permOfUpdateTools | bool}"
    brick: "your-brick-a"
  - if:
      useProvider: "your-permission-provider"
      transform:
        if: "@{permOfUpdateTools | not}"
    brick: "your-brick-b"

当系统渲染时，如果 your-permission-provider 返回的对象中的 permOfUpdateTools 为 true 时，页面将显示 your-brick-a 构件，反之将显示为 your-brick-b 。

注意： 当使用 Resolvable 条件时，应始终返回一个 { if?: boolean } 的对象。