1.3-XAML语法基础：标记扩展原理

1.3-XAML语法基础：标记扩展原理

标记扩展，本质上是IMarkupExtension或者IMarkupExtension接口的实现类。这两个接口，均定义了ProvideValue方法。注意，IMarkupExtension继承自IMarkupExtension，如果定义的标记扩展类，需要实现IMarkupExtension泛型接口，则返回值为object和返回值为泛型T的两个ProvideValue方法，均要实现。

public interface IMarkupExtension
{
    object ProvideValue(IServiceProvider serviceProvider);
}

public interface IMarkupExtension<out T> : IMarkupExtension
{
    new T ProvideValue(IServiceProvider serviceProvider);
}

下面以官方文档的例子，来定义一个为颜色属性赋值的标记扩展。

//创建一个标记扩展类
public class HslColorExtension : IMarkupExtension<Color>
{
    //定义4个属性，“使用”标记扩展时，可以给属性赋值初始化
    public float H { get; set; }
    public float S { get; set; }
    public float L { get; set; }
    public float A { get; set; } = 1.0f;

    //ProvideValue的返回值，将提供给 使用了 标记扩展的元素
    public Color ProvideValue(IServiceProvider serviceProvider)
    {
        return Color.FromHsla(H,S,L,A);
    }

    //这段代码主要原因是因为IMarkupExtension<T>继承自IMarkupExtension
    //所以父接口的方法也要实现，这个方法可以调用上面的ProvideValue方法
    object IMarkupExtension.ProvideValue(IServiceProvider serviceProvider)
    {
        return (this as IMarkupExtension<Color>).ProvideValue(serviceProvider);
    }
}


//在XAML中，分别用大括号和尖括号的方式来使用自定义的标记扩展
<ContentPage
    x:Class="MauiApp7.MainPage"
    xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
    xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
    xmlns:local="clr-namespace:MauiApp7"
    xmlns:localext="clr-namespace:MauiApp7.MarkupExtension">

    <StackLayout Padding="10,0">
        <Label Text="大括号语法使用自定义的标记扩展" TextColor="{localext:HslColorExtension H=0.2, S=0.5, L=0.7}" />
        <Label Text="尖括号语法使用自定义的标记扩展">
            <Label.TextColor>
                <localext:HslColorExtension H="0.1" S="0.3" L="0.5"/>
            </Label.TextColor>
        </Label>
    </StackLayout>
</ContentPage>

看完以上自定义的标记扩展，有没有恍然大悟的感觉？我们说元素的本质，是实例化一个对象。那么标记扩展的本质，也是在实例化一个对象，只是XAML编译器，会调用标记扩展对象的ProvideValue方法，并将返回值赋值给使用了标记扩展的 属性。大括号的标记扩展语法，直接给 属性 赋值，更加简洁；而尖括号语法，给 属性元素 赋值，可以完成更加复杂的表达。x:Array不能使用大括号的原因，估计是因为数组表达比较复杂，无法在大括号里写，所以只能使用尖括号的方式。

最后，我们来看一下ProvideValue方法的IServiceProvider参数，这是一个服务定位器吗？通过它，可以获得使用了标记扩展的XAML文件对象。比如下面这段代码，可以获取使用了标记扩展的对象，IProvideValueTarget接口定义了两个属性， TargetObject和TargetProperty。对照上例，TargetObject就是Lable，TargetProperty就是TextColor。通过ServiceProvider获得XAML文件的对象后，我们就可以执行更加复杂的逻辑计算，以返回我们需要的值。

var provideValueTarget = serviceProvider.GetService(typeof(IProvideValueTarget)) as IProvideValueTarget;