优维低代码：Template State 模板状态数据

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

---

连载第二十四期

《高级指引：Template State 模板状态数据》

▽

有时候我们希望在模板内进行消费类似 Context 上下文的数据，但又希望这些数据能控制在模板实例的作用域下：数据封装在模板内部、外部不可访问，同时一个模板的多个实例之间的数据互不影响。Template State 模板状态数据正是为了解决这个问题。

# 示例

定义：

customTemplates:
  - name: "tpl-my-awesome-button"
    state:
      # 状态数据，在模板外部可以通过给模板传递属性来初始化状态数据。
      - name: "buttonDisabled"
        # 可以设置默认值，在外部没有传递对应属性时使用。
        value: true
    bricks:
      - brick: "my-button"
        properties:
          # 在模板内部，通过表达式变量 `STATE` 来读取状态数据。
          disabled: "<% STATE.buttonDisabled %>"
      - brick: "my-trigger"
        events:
          click:
            # 在模板内部，通过内置事件处理来更新状态数据。
            action: "state.update"
            args:
              - "buttonDisabled"
              - false

该状态数据作用域为模板实例，因此，同一个模板的多个实例之间的数据是隔离的。另外该状态数据只能用于模板内部，无法用于模板外部，包括模板对外暴露的插槽中加入的外部构件。

在模板外部传递状态数据：

bricks:
  - brick: "tpl-my-awesome-button"
    properties:
      # 设置初始属性
      buttonDisabled: false
      id: "button-a"
  - brick: "my-toggle"
    events:
      click:
        # 动态地给模板设置属性来变更它的状态数据（需要配合 `"track state"` 使用）
        target: "#button-a"
        properties:
          buttonDisabled: true

除上述示例列出的能力外，已支持的其它能力（类比 CTX）：

• 条件判断 if
• 属性追踪 "track state"
• 异步数据 resolve（仅限使用在普通编排中的模板。在 useBrick 中使用模板时，该模板不能定义 resolve的数据）
• 懒加载 lazy state.load
• 主动更新 state.refresh
• 追踪依赖 track

⊙ NOTE

如果该模板用于useBrick中，目前不可以使用 resolve 来定义异步的状态数据。