如何从XAML向Xamarin.Forms自定义Checkbox视图传递参数？

嘿，我来帮你搞定这个问题！你现在写的自定义Checkbox里的BackgroundColor是普通CLR属性，Xamarin.Forms的XAML没法直接识别这类属性来传递参数——要让XAML能设置或绑定自定义视图的属性，得把它们定义成BindableProperty（可绑定属性），这是Xamarin.Forms控件和XAML交互的核心机制，具体操作看下面：

第一步：把普通属性替换为可绑定属性 #

修改你的Checkbox类，把BackgroundColor改成可绑定属性，顺便给那个固定文本的lbl1也加个可绑定的Text属性，这样XAML里就能自定义显示文本了：

[Xamarin.Forms.ContentProperty("Content")]
public class Checkbox : ContentView 
{
    // 复选框图标Label
    private Label _checkIcon = new Label() { Text = "\u2610" };
    // 文本Label
    private Label _textLabel = new Label();

    // 定义BackgroundColor的可绑定属性，带属性变化回调
    public static readonly BindableProperty BackgroundColorProperty =
        BindableProperty.Create(nameof(BackgroundColor), typeof(Color), typeof(Checkbox), Color.Default, propertyChanged: OnBackgroundColorChanged);

    public Color BackgroundColor
    {
        get => (Color)GetValue(BackgroundColorProperty);
        set => SetValue(BackgroundColorProperty, value);
    }

    // 新增可绑定的Text属性，用于传递XAML里的自定义文本
    public static readonly BindableProperty TextProperty =
        BindableProperty.Create(nameof(Text), typeof(string), typeof(Checkbox), "已送达", propertyChanged: OnTextChanged);

    public string Text
    {
        get => (string)GetValue(TextProperty);
        set => SetValue(TextProperty, value);
    }

    // 背景色变化时更新UI的回调方法
    private static void OnBackgroundColorChanged(BindableObject bindable, object oldValue, object newValue)
    {
        if (bindable is Checkbox checkbox && newValue is Color color)
        {
            checkbox._checkIcon.BackgroundColor = color;
            checkbox._textLabel.BackgroundColor = color;
            // 也可以给整个StackLayout设置背景色
            if (checkbox.Content is StackLayout stack)
                stack.BackgroundColor = color;
        }
    }

    // 文本变化时更新UI的回调方法
    private static void OnTextChanged(BindableObject bindable, object oldValue, object newValue)
    {
        if (bindable is Checkbox checkbox && newValue is string text)
        {
            checkbox._textLabel.Text = text;
        }
    }

    public Checkbox()
    {
        var tapGesture = new TapGestureRecognizer();
        tapGesture.Tapped += OnTapped;

        var stackLayout = new StackLayout() 
        { 
            Orientation = StackOrientation.Horizontal,
            Children = { _checkIcon, _textLabel }
        };
        stackLayout.GestureRecognizers.Add(tapGesture);
        Content = stackLayout;
    }

    private void OnTapped(object sender, EventArgs e)
    {
        // 切换复选框选中状态的逻辑
        _checkIcon.Text = _checkIcon.Text == "\u2610" ? "\u2611" : "\u2610";
    }
}

第二步：在XAML中传递参数 #

现在你可以像使用原生控件一样，在XAML里直接设置自定义Checkbox的属性了：

首先要在XAML根节点声明自定义视图的命名空间（假设你的Checkbox在MyApp.Controls命名空间下）：

xmlns:controls="clr-namespace:MyApp.Controls"

然后就可以直接传递参数了：

<!-- 直接设置静态参数 -->
<controls:Checkbox 
    BackgroundColor="#F0F0F0"
    Text="已签收" />

<!-- 绑定ViewModel里的属性（MVVM场景） -->
<controls:Checkbox 
    BackgroundColor="{Binding CheckboxBgColor}"
    Text="{Binding CheckboxText}" />

额外小技巧：利用ContentProperty简化写法 #

你已经给类标记了[ContentProperty("Content")]，不过因为继承自ContentView，这个属性已经默认存在了。如果想让XAML写法更简洁，可以把ContentProperty改成Text，这样就能直接把文本写在标签内部：

// 修改ContentProperty属性
[Xamarin.Forms.ContentProperty("Text")]
public class Checkbox : ContentView 
{
    // ... 其他代码不变
}

对应的XAML就可以写成：

<controls:Checkbox BackgroundColor="#F0F0F0">已签收</controls:Checkbox>

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