跳到主要内容

数据绑定概述

数据绑定会把存储在 视图模型(View Model) 中的数据连接到 Rive 场景里的属性。

当数据发生变化时,你的场景会自动更新。同样,场景中发生的变化也可以写回数据。

例如,你可以:

  • 绑定敌人的 X / Y 位置,让它们在运行时由应用控制。
  • 将多个图标的颜色绑定到同一个颜色属性。
  • health 值同时绑定到 UI 里的血条和角色状态。
  • 根据应用状态切换图片、画板或组件。

为什么使用数据绑定?

数据绑定让你可以把数据组织方式与场景层级分离。

例如,你可以把 health 属性存放在顶层数据中,而显示它的血条可能嵌套在多层组件内部。

只要属性完成绑定,层级结构就不再重要。你可以移动元素、重组组件或重命名场景节点,而不必重写运行时代码。

核心概念

  1. 视图模型 定义数据结构。
  2. 视图模型实例保存这些数据的实际值。
  3. 绑定数据 将视图模型数据连接到场景中的属性。
  4. 控制数据 可以来自编辑器、运行时代码、状态机或脚本。
  5. 数据变化时,已绑定元素会自动更新以反映新值。

建议阅读顺序

如果你是第一次学习数据绑定,建议按下面顺序阅读:

  1. 视图模型与实例
  2. 视图模型属性
  3. 绑定数据
  4. 控制数据
  5. 高级主题:枚举、列表、转换器、状态化组件、属性组与迁移指南。