syncfusion-maui-toolkit-shimmer

实现 .NET MAUI Shimmer（SfShimmer）

SfShimmer 会在内容于后台加载时显示动画 shimmer 占位内容，提升应用响应速度的感知体验。它支持 7 种内置布局类型、使用 ShimmerView 形状创建的完全自定义视图，以及丰富的波浪动画自定义选项。

何时使用此技能

当用户需要以下功能时，请使用此技能：

• 添加加载占位内容，以便在获取数据或内容之前显示
• 显示骨架屏，等待 API 调用完成
• 用符合内容形状的加载动画替代加载指示器
• 自定义 shimmer 颜色、波浪方向或动画速度
• 构建自定义 shimmer 布局，使其与实际 UI 相匹配

组件概述

SfShimmer 控件提供：

• 内置布局类型：7 种预设 shimmer 模式（CirclePersona、SquarePersona、Profile、Article、Video、Feed、Shopping）
• 自定义视图支持：使用 ShimmerView 和 Circle、Rectangle、RoundedRectangle 形状构建自定义 shimmer 布局
• 波浪动画控制：可配置波浪方向（5 种选项）、宽度和动画时长
• 颜色自定义：可分别设置 Fill（背景）和 WaveColor（高亮）属性
• 重复模式：使用 RepeatCount 属性垂直堆叠 shimmer 布局
• 内容切换：使用 IsActive 属性，在 shimmer 和已加载内容之间无缝切换
• 灵活集成：可将任意 .NET MAUI View 用作子内容
• 性能优化：轻量级动画，可提升应用响应速度的感知体验

文档和导航指南

入门

📄 阅读： references/getting-started.md

• 安装 Syncfusion.Maui.Toolkit NuGet 包
• 在 MauiProgram.cs 中注册处理程序
• 在 XAML 和 C# 中添加 SfShimmer
• 使用 IsActive 在 shimmer 和内容之间切换

内置视图类型

📄 阅读： references/built-in-views.md

• 7 种内置 ShimmerType 值：CirclePersona、SquarePersona、Profile、Article、Video、Feed、Shopping
• 在 XAML 和 C# 中设置 Type 属性
• 默认类型以及各布局的适用场景

自定义视图

📄 阅读： references/custom-views.md

• 使用 CustomView 和 BoxView 构建自定义 shimmer 布局
• 使用带有 ShapeType（Circle、Rectangle、RoundedRectangle）的 ShimmerView
• 复杂自定义布局的完整 XAML 和 C# 示例

自定义和动画

📄 阅读： references/customization.md

• Fill — shimmer 背景颜色
• WaveColor — shimmer 高亮颜色
• WaveWidth — 高亮波浪的宽度
• WaveDirection — 5 种方向（Default、LeftToRight、RightToLeft、TopToBottom、BottomToTop）
• RepeatCount — 垂直重复 shimmer 模式
• AnimationDuration — 以毫秒为单位控制动画速度