Unity UI Toolkit如何为单个Visual Element绑定多个数据属性？

Unity UI Toolkit支持为同一个VisualElement绑定多个数据属性，完全可以实现类似WPF的多属性绑定效果，无需局限于单个binding-path。下面是具体的实现方法：

第一步：准备符合绑定要求的数据类 #

UI Toolkit的属性自动更新依赖INotifyPropertyChanged接口，同时为了支持编辑器可视化绑定，类需要添加可序列化标签，先修正你的Player类：

using System.ComponentModel;
using UnityEngine;

[Serializable]
public class Player : INotifyPropertyChanged
{
    private int _lives;
    private bool _isAlive;

    public int Lives
    {
        get => _lives;
        set
        {
            _lives = value;
            OnPropertyChanged(nameof(Lives));
        }
    }

    public bool IsAlive
    {
        get => _isAlive;
        set
        {
            _isAlive = value;
            OnPropertyChanged(nameof(IsAlive));
        }
    }

    public event PropertyChangedEventHandler PropertyChanged;

    private void OnPropertyChanged(string propertyName)
    {
        PropertyChanged?.Invoke(this, new PropertyChangedEventArgs(propertyName));
    }
}

方法一：通过C#代码手动添加多绑定 #

这种方式灵活可控，适合复杂绑定场景：

1. 先创建一个值转换器，将bool类型的IsAlive转换为UI Toolkit的Visibility枚举：

using System;
using System.Globalization;
using UnityEngine.UIElements;

public class BoolToVisibilityConverter : IValueConverter
{
    public object Convert(object value, Type targetType, object parameter, CultureInfo culture)
    {
        return value is bool isAlive 
            ? isAlive ? Visibility.Visible : Visibility.Hidden 
            : Visibility.Visible;
    }

    public object ConvertBack(object value, Type targetType, object parameter, CultureInfo culture)
    {
        // 无需双向绑定可留空
        throw new NotImplementedException();
    }
}

2. 在UI初始化代码中，为Label绑定两个属性：

var root = GetComponent<UIDocument>().rootVisualElement;
var livesLabel = root.Q<Label>("labelName");
var player = new Player { Lives = 3, IsAlive = true };

// 绑定文本到Lives属性
livesLabel.BindProperty(new BindingPath("Lives"), player);

// 绑定可见性到IsAlive属性，使用转换器
var isAliveBinding = new Binding("IsAlive")
{
    Converter = new BoolToVisibilityConverter(),
    TargetProperty = nameof(Label.visibility)
};
livesLabel.AddBinding(isAliveBinding, player);

方法二：使用编辑器可视化绑定（无需手写大量代码） #

适合快速配置简单绑定：

1. 在Unity编辑器中打开你的UXML文件，选中目标Label元素；
2. 在Inspector面板的Binding区域，点击+添加新绑定：
   • 第一个绑定：设置Path为Lives，Target Property选择text；
   • 第二个绑定：设置Path为IsAlive，Target Property选择visibility，然后在Converter下拉框中选择你之前创建的BoolToVisibilityConverter；
3. 运行时只需要给根元素绑定Player实例即可自动更新：

var root = GetComponent<UIDocument>().rootVisualElement;
var player = new Player { Lives = 3, IsAlive = true };
root.Bind(new SerializedObject(player));

注意事项 #

• UXML中的binding-path是单个属性的快捷绑定语法，无法直接添加多个绑定，但通过上述两种方式可以实现多属性绑定；
• 确保数据类实现INotifyPropertyChanged，否则属性变更无法自动同步到UI；
• 如果使用序列化绑定（SerializedObject），数据类必须添加[Serializable]标签。

内容的提问来源于stack exchange，提问作者Aldoras