跳到主要内容

脚本输入(Script Inputs)

脚本输入(Script Inputs)是脚本与 Rive 编辑器之间的桥梁,使你可以通过自定义输入字段来配置并控制脚本行为。

通过定义输入,你可以暴露数字、颜色、布尔值、视图模型实例和画板组件等可配置属性,这些属性会直接显示在 Rive 界面中。这样你可以编写一次脚本逻辑,然后自由地尝试不同的值、随时间动画化属性、绑定外部数据源,并在多个实例中复用同一脚本使用不同配置。

输入将静态脚本转变为灵活的、设计师友好的工具,实现真正的协作和快速迭代。

定义输入(Define Inputs)

要创建脚本输入,请在类型中声明,并在返回函数中提供默认值。

-- Define the script's data and inputs.
type ScriptInputs = {
score: Input<number>,
menu: Input<Data.MenuVM>,
newArtboard: Input<Artboard<Data.NewVM>>,
}

-- Return a factory function that Rive uses to build the Node instance.
return function(): Node<ScriptInputs>
return {
score = 0,
menu = late(),
newArtboard = late(),
}
end

社区文件:Script Inputs

设置输入值(Set Input Values)

在层级面板中选择 节点(Node)布局脚本(Layout Scripts) 的组件,或在数据面板选择 转换器脚本(Converter Scripts),即可在右侧侧栏配置输入。

Node script input

数据绑定输入(Data Binding Inputs)

你可以使用数据绑定(Data Binding)在运行时控制输入值。

在右侧边栏中对输入字段右键,选择 Data Bind,并绑定属性。

Data bind a converter input

监听输入变化(Listen for Input Changes)

当任意输入变化时,update 会触发:

function update(self: MyNode)
print('An update changed')
end
看完还有疑问?进群交流下!
与众多 Rive 创作者、开发者一起交流探讨与答疑解惑。
加入交流群