syncfusion-maui-shimmer

实现 .NET MAUI Shimmer（SfShimmer）

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

何时使用此技能

在以下情况下使用此技能：

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

组件概览

SfShimmer 控件提供：

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

文档和导航指南

入门

📄 阅读： references/getting-started.md

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

内置视图类型

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

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

自定义视图

📄 阅读： references/custom-views.md

• 使用 CustomView 和 BoxView 构建自定义闪烁布局
• 将 ShimmerView 与 ShapeType（Circle、Rectangle、RoundedRectangle）配合使用
• 复杂自定义布局的完整 XAML 和 C# 示例

自定义和动画

📄 阅读： references/customization.md

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