文本（Text）

警告（Warning）：本页是旧版 Text Run 直控方案。新项目请使用 Data Binding。

旧版 Text Run 工作流

历史上可以在运行时通过 text run 名称直接读写文本：

但要生效，编辑器侧必须：

否则运行时无法查询到该 run。

const r = new Rive({ src: 'my.riv', onLoad: () => {
  console.log(r.getTextRunValue('MyRun'));
  r.setTextRunValue('MyRun', 'New text');
}});

useEffect(() => {
  if (!rive) return;
  rive.setTextRunValue('MyRun', 'New Text');
}, [rive]);

新版 ref 仍有 get/setTextRunValue（兼容用途），但推荐迁移 Data Binding String。

Legacy 通过 RiveRef 的 setTextRunValue 完成。

可在 Artboard 上读写：

artboard.getText('runName');
artboard.setText('runName', 'new value');

两端都提供 text run 读写 API；当 run 不存在时通常会抛错或返回空值，需做好异常处理。

可通过 path 更新组件内部 text run，例如：

ArtboardWithUniqueName/ButtonWithUniqueName

注意：

Rive 文本在部分平台不等同原生文本节点，建议额外补充：

以保证屏幕阅读器可读性。