SuperAPI AI 工具集

syncfusion-maui-toolkit-shimmer

前端与建站

查看项目

更新于 10-16 02:21

技能介绍

Syncfusion .NET MAUI Shimmer(SfShimmer)用于在内容于后台加载期间显示动画微光占位效果,以提升应用响应感知。

用途 该控件用于添加加载占位、在 API 调用完成期间展示骨架屏、以贴合内容形状的加载动画替代旋转加载指示器。

主要能力

  • 内置布局类型:7 种预设计微光模式,包括 CirclePersona、SquarePersona、Profile、Article、Video、Feed、Shopping,可通过 Type 属性在 XAML 和 C# 中设置。
  • 自定义视图:使用 ShimmerView 搭配 Circle、Rectangle、RoundedRectangle 形状,或使用 CustomView 与 BoxView 构建自定义微光布局。
  • 波纹动画控制:可配置波纹方向(5 种选项:Default、LeftToRight、RightToLeft、TopToBottom、BottomToTop)、波纹宽度(WaveWidth)以及动画时长(AnimationDuration,单位为毫秒)。
  • 颜色自定义:Fill 属性控制微光背景色,WaveColor 属性控制微光高亮色。
  • 重复模式:RepeatCount 属性用于纵向堆叠微光布局。
  • 内容切换:IsActive 属性用于在微光与已加载内容之间无缝切换。
  • 集成方式:可与任意 .NET MAUI View 作为子内容配合使用。
  • 性能:轻量动画,用于改善应用响应感知。

使用方式

  1. 安装 Syncfusion.Maui.Toolkit NuGet 包。
  2. 在 MauiProgram.cs 中注册处理程序。
  3. 在 XAML 和 C# 中添加 SfShimmer。
  4. 使用 IsActive 在微光与内容之间切换。

相关文档参考包括:getting-started.md(入门,涵盖 NuGet 安装、处理程序注册、XAML/C# 添加、IsActive 切换);built-in-views.md(内置视图,涵盖 7 种 ShimmerType、XAML/C# 设置 Type、默认类型及每种布局的选用);custom-views.md(自定义视图,涵盖 CustomView 与 BoxView、ShimmerView 的 ShapeType、复杂自定义布局的 XAML 与 C# 示例);customization.md(自定义与动画,涵盖 Fill、WaveColor、WaveWidth、WaveDirection、RepeatCount、AnimationDuration)。

适用场景 需要在数据或内容获取前显示加载占位、在 API 调用完成时展示骨架屏、以贴合内容的加载动画替代旋转指示器、自定义微光颜色/波纹方向/动画速度,或构建映射实际 UI 的自定义微光布局时使用。

限制 关于收费、价格、平台支持范围、具体性能指标或效果数据,资料中暂未提供。