syncfusion-maui-shimmer

.NET MAUI Shimmer（SfShimmer）の実装

SfShimmer は、コンテンツの読み込み中にアニメーションするシマーのプレースホルダーを表示し、アプリの応答性を体感上向上させます。7 種類の組み込みレイアウトタイプ、ShimmerView のシェイプを使用した完全なカスタムビュー、幅広い波のアニメーション設定に対応しています。

このスキルを使用する場面

次のような場合に、このスキルを使用してください。

• データやコンテンツの取得前にローディング用プレースホルダーを追加する
• API 呼び出しの完了を待つ間、スケルトンスクリーンを表示する
• コンテンツの形状に沿ったローディングアニメーションでスピナーを置き換える
• シマーの色、波の方向、アニメーション速度をカスタマイズする**
• 実際の UI を再現するカスタムシマーレイアウトを構築する

コンポーネントの概要

SfShimmer コントロールには、次の機能があります。

• 組み込みレイアウトタイプ：あらかじめデザインされた 7 種類のシマーパターン（CirclePersona、SquarePersona、Profile、Article、Video、Feed、Shopping）
• カスタムビューのサポート：Circle、Rectangle、RoundedRectangle のシェイプを持つ ShimmerView を使って、カスタムシマーレイアウトを構築できます
• 波のアニメーション制御：波の方向（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 を使ったカスタムシマーレイアウトの構築
• ShapeType（Circle、Rectangle、RoundedRectangle）を指定した ShimmerView の使用
• 複雑なカスタムレイアウトの XAML と C# のサンプル

カスタマイズとアニメーション

📄 参照： references/customization.md

• Fill — シマーの背景色
• WaveColor — シマーのハイライト色
• WaveWidth — 波のハイライトの幅
• WaveDirection — 5 種類の方向（Default、LeftToRight、RightToLeft、TopToBottom、BottomToTop）
• RepeatCount — シマーパターンを垂直方向に繰り返します
• AnimationDuration — ミリ秒単位でアニメーション速度を設定します