Skip to content

Conversation

@mfazekas
Copy link
Collaborator

@mfazekas mfazekas commented Dec 22, 2025

Summary

  • Add support for swapping artboards at runtime via data binding properties
  • Enables composing complex scenes from artboards in different Rive files

New APIs

  • RiveFile.getBindableArtboard(name) - create bindable artboard reference
  • RiveFile.artboardNames / artboardCount - enumerate artboards
  • ViewModelInstance.artboardProperty(path) - get artboard property
  • ViewModelArtboardProperty.set(artboard) - swap artboard at runtime

Example

const mainFile = useRiveFile(require('./scene.riv'));
const assetsFile = useRiveFile(require('./characters.riv'));

const instance = mainFile.defaultArtboardViewModel()?.createDefaultInstance();
const artboardProp = instance.artboardProperty('CharacterArtboard');

// Swap to a different character
const character = assetsFile.getBindableArtboard('Character 1');
artboardProp.set(character);
rive.mov

References

Add support for swapping artboards at runtime via data binding properties.
This enables composing complex scenes from artboards in different Rive files.

New APIs:
- RiveFile.getBindableArtboard(name) - create bindable artboard reference
- RiveFile.artboardNames / artboardCount - enumerate artboards
- ViewModelInstance.artboardProperty(path) - get artboard property
- ViewModelArtboardProperty.set(artboard) - swap artboard at runtime
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants