ColorAnimationExtensions

ColorAnimationExtensions 提供一系列扩展方法,支持对 VisualElementColor 相关属性进行动画处理。

可以在 CommunityToolkit.Maui.Extensions 命名空间下查找 ColorAnimationExtensions,因此只需添加以下行即可开始使用:

using CommunityToolkit.Maui.Extensions;

BackgroundColorTo

使用 BackgroundColorTo 方法可以对 VisualElementBackgroundColor 变化进行动画处理。

语法

以下示例演示了如何将 LabelBackgroundColorColors.White 动画处理为 Colors.Red

using CommunityToolkit.Maui.Extensions;

var label = new Label
{
    BackgroundColor = Colors.White
};

await label.BackgroundColorTo(Colors.Red);

BackgroundColorTo 方法的完整参数列表为:

  • 类型为 Colorcolor 是对 VisualElementBackgroundColor 进行动画处理的目标颜色。
  • 类型为 uintrate 是动画帧之间的时间(以毫秒为单位)。 这是一个可选参数,其默认值为 16。
  • 类型为 uintlength 是动画的持续时间(以毫秒为单位)。 这是一个可选参数,其默认值为 250。
  • 类型为 Easingeasing 是动画中使用的缓动函数。 此参数是可选参数,其默认值为 null

TextColorTo

使用 TextColorTo 方法可以对 ITextStyle 实现的 TextColor 变化进行动画处理。

using CommunityToolkit.Maui.Extensions;

var label = new Label
{
    TextColor = Colors.Green
};

await label.TextColorTo(Colors.Red);

TextColorTo 方法的完整参数列表为:

  • 类型为 Colorcolor 是对 VisualElementBackgroundColor 进行动画处理的目标颜色。
  • 类型为 uintrate 是动画帧之间的时间(以毫秒为单位)。 这是一个可选参数,其默认值为 16。
  • 类型为 uintlength 是动画的持续时间(以毫秒为单位)。 这是一个可选参数,其默认值为 250。
  • 类型为 Easingeasing 是动画中使用的缓动函数。 此参数是可选参数,其默认值为 null

注意

TextColorTo 方法是在编译时通过使用源生成器生成的。 这是因为 ITextStyle.TextColor 是只读的。 可以在 .NET MAUI 社区工具包 GitHub 存储库中找到源生成器的源代码

示例

可以在 .NET MAUI 社区工具包示例应用程序中查找此扩展的示例。

API

可以在 .NET MAUI 社区工具包 GitHub 存储库查看ColorAnimationExtensions 的源代码