Unity UI Toolkit Data Binding

unity.properties

Core Features

1. BindableProperty<T>: A wrapper class that uses

   [CreateProperty]

   to expose values to the UI Toolkit binding engine.
2. MVVM (Model-View-ViewModel): Separates raw game data from UI-formatted data using a ViewModel mediator.
3. Reactive Synchronization: UI elements update automatically when the underlying property value changes (or is polled by the engine).
4. C# Based Binding: Set up complex bindings programmatically without relying on the UI Builder's inspector fields.

Core Files (Max 3)

• BindableProperty.cs.txt

  : Generic property wrapper for data sources.

• BindingExample.cs.txt

  : Practical example showing a Coin display and Health bar bound to a ViewModel.

Usage

1. Define the ViewModel

BindableProperty

public BindableProperty<string> HealthText { get; }
HealthText = BindableProperty<string>.Bind(() => $"HP: {model.hp}/{model.maxHp}");

2. Set the Data Source

dataSource

root.dataSource = myViewModel;

3. Establish the Binding

SetBinding

label.SetBinding("text", "HealthText.Value");

Key Principle