跳到主要内容

视图模型属性

视图模型属性是视图模型中的一条数据。开发人员可以把它理解为面向对象编程中的字段。属性具有创建时选择的数据类型,以及一个可在代码中引用的名称。每个属性都可以绑定到相同类型的不同编辑器元素,也可以作为状态机条件使用。

添加视图模型属性​

在 Data 面板中,点击视图模型名称旁边的 Add View Model Property 按钮,然后选择你的属性类型。

创建属性

类型描述
数字(Number)数值
字符串(String)文本值
布尔(Boolean)true/false 值
颜色(Color)RGBA 颜色值
触发器(Trigger)发射后即忘的事件
枚举(Enum)从预定义列表中选择一个值
图像(Image)图像资源引用
字体(Font)字体资源引用
二进制块(Blob)Blob 资源引用
画板(Artboard)画板引用
视图模型(View Model)嵌套的视图模型实例
列表(List)视图模型的集合

属性类型​

触发器(Trigger)​

触发器属性代表“发射后即忘”的事件。当你需要表示某事已发生时使用,例如按钮按下或一次性操作。

枚举(Enum)​

从固定的选项集中选择以控制状态和变体。当可能的值事先已知时使用枚举。

了解更多关于枚举。

图像(Image)​

绑定图像

图像属性存储对图像的引用,允许你更改显示的图像。它们通常绑定到设计中的图像节点。

当每个实例需要自己的图像时使用图像属性,例如用户头像、缩略图或动态加载的内容。

例如,在游戏或社交 UI 中,每个玩家可以通过将不同图像绑定到同一属性来拥有自己的头像。

备注

图像属性影响单个实例。

如果你需要在整个文件中全局更新图像,请使用资源加载。资源加载会替换底层资源,更新所有使用它的实例。

字体(Font)​

字体属性存储对字体的引用,允许你更改特定文本样式上显示的字体。

备注

社区文件:Data Binding Fonts

备注

字体属性影响单个实例。

如果你需要在整个文件中全局更新字体,请使用资源加载。资源加载会替换底层资源,更新所有使用它的实例。

二进制块(Blob)​

Blob 属性存储对 Blob 资源 的引用,让你可以将任意二进制数据(例如自定义文件格式)绑定到视图模型。

要绑定 Blob,先导入 Rive 无法原生识别的文件并选择 Import as Blob,然后将其绑定到 Blob 属性。

脚本可以在运行时读写 Blob 的字节。请参阅 Scripting API 参考中的 Blob。

画板(Artboard)​

绑定画板

画板属性让你引用一个画板并在运行时动态替换它。

画板可以来自当前的 Rive 文件,也可以从另一个 .riv 文件加载。

要将画板用作属性,必须先将其转换为组件。

视图模型(View Model)​

视图模型属性存储对视图模型实例的引用。

它们用于通过将一个视图模型实例连接到另一个实例来创建嵌套数据结构。

例如,Player 视图模型可以包含一个 Team 视图模型属性,从而访问球队名称、徽标和颜色等属性。

你可以像处理顶层属性一样,绑定和更新嵌套视图模型上的属性。

备注

如果你想将一个视图模型实例分配给嵌套组件,该实例必须从你的主视图模型中引用。

列表(List)​

列表属性存储视图模型实例的集合,这些实例可以与特定画板关联。

列表常用于重复内容,例如库存物品、玩家、消息或生成式 UI 元素。

更多信息请参阅列表。

看完还有疑问?进群交流下!
与众多 Rive 创作者、开发者一起交流探讨与答疑解惑。
加入交流群