优维低代码技术专栏,是一个全新的、技术为主的专栏,由优维技术委员会成员执笔,基于优维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 } 的对象。