跳到主要内容

属性类型(Property Types)

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

触发器(Trigger)

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

枚举(Enum)

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

了解更多关于枚举。

图像(Image)

绑定图像

图像属性存储对图像的引用,允许你更改显示的图像。

它们通常绑定到设计中的图像节点。

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

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

图像属性影响单个实例

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

画板(Artboard)

绑定画板

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

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

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

视图模型(View Model)

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

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

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

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

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

列表(List)

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

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

更多信息请参见列表