syncfusion-maui-toolkit-pull-to-refresh

.NET MAUI PullToRefresh（SfPullToRefresh）の実装

Syncfusion .NET MAUI PullToRefresh コントロールを使用すると、プルダウンジェスチャーでコンテンツをインタラクティブに更新できます。プル操作中は進行状況インジケーターが表示され、ユーザーがしきい値を超えてプルした後に指を離すと、コンテンツの更新が開始されます。

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

次のような場合に、このスキルを使用します。

• .NET MAUI アプリケーションで、必要に応じてコンテンツを更新するプルツーリフレッシュ機能を実装する
• ListView、DataGrid、カスタムレイアウトなどのスクロール可能なビューにインタラクティブな更新コントロールを追加する
• プルツーリフレッシュ操作中に、アニメーション付きの進行状況インジケーターを表示する
• 色、サイズ、遷移モード、しきい値などを含め、更新時の表示をカスタマイズする
• プログレスバーやアニメーション付きビューを使ってカスタム更新テンプレートを作成する
• 更新コマンドとデータバインディングを使ってMVVM パターンを統合する
• プル操作、更新、完了の各処理を制御する更新イベントを処理する
• 適切な更新動作を保ちながら、プル可能なコンテンツ領域内に複雑なビューをホストする

コンポーネントの概要

• インタラクティブなプルツーリフレッシュジェスチャーの認識
• 2 つの遷移モード：SlideOnTop と Push
• カスタマイズ可能な進行状況インジケーターの外観
• 任意の .NET MAUI ビューをプル可能なコンテンツとしてホスト可能
• RefreshCommand とデータバインディングに対応した MVVM 互換性
• プル中および更新中のビュー向けカスタムテンプレート
• 細かな更新制御に使える組み込みイベント
• プログラムによる更新の開始と完了

ドキュメントとナビゲーションガイド

はじめに

📄 参照： references/getting-started.md

参照するタイミング：初回のセットアップ、インストール、基本的な実装

• Syncfusion.Maui.Toolkit NuGet パッケージのインストール
• Syncfusion ハンドラーの登録（ConfigureSyncfusionToolkit）
• 基本的な SfPullToRefresh インスタンスの作成
• PullableContent の定義
• IsRefreshing プロパティの処理
• 初めてのプルツーリフレッシュアプリケーションの実行

プル可能なコンテンツ

📄 参照： references/pullable-content.md

参照するタイミング：プルジェスチャーに応答するコンテンツの構成

• PullableContent プロパティについて
• .NET MAUI DataGrid を PullToRefresh 内にホストする
• .NET MAUI ListView を PullToRefresh 内にホストする
• カスタムビューとレイアウトの読み込み
• プル可能なコンテンツを構成する際のベストプラクティス
• さまざまなビューを使ったコンテンツ更新の処理

カスタマイズとプロパティ

📄 参照： references/customization.md

参照するタイミング：外観、動作、しきい値、遷移モードのカスタマイズ

• TransitionMode：SlideOnTop と Push のアニメーション
• PullingThreshold と RefreshViewThreshold の構成
• 更新状態を制御する IsRefreshing プロパティ
• 進行状況インジケーターのカスタマイズ（色、太さ、サイズ）
• RefreshViewWidth プロパティと RefreshViewHeight プロパティ
• ProgressBackground、ProgressColor、ProgressThickness
• プログラムによるメソッド：StartRefreshing() と EndRefreshing()
• サイズとレイアウトに関する考慮事項

カスタムテンプレート

📄 参照： references/templates.md

参照するタイミング：カスタムのプル中および更新中のビューの作成

• PullingViewTemplate プロパティ
• RefreshingViewTemplate プロパティ
• テンプレートでの SfCircularProgressBar の使用
• カスタム進行状況インジケーターの DataTemplate の作成
• Pulling イベントとテンプレートの統合
• 更新ビューのアニメーション化
• テンプレートのカスタマイズ例

MVVM とコマンド

📄 参照： references/mvvm-commands.md

参照するタイミング：PullToRefresh での MVVM パターンの実装

• MVVM 互換性の概要
• IsRefreshing と ViewModel プロパティのバインド
• RefreshCommand と RefreshCommandParameter の使用
• 更新操作を制御する CanExecute() メソッド
• INotifyPropertyChanged の実装
• ViewModel の完全な例
• ViewModel からのプル操作のキャンセル

イベント

📄 参照: references/events.md

参照するタイミング：プルして更新する際のライフサイクルイベントを処理するとき

• PullingEventArgs を使用する Pulling イベント
• ポインターを離したときの Refreshing イベント
• 完了時の Refreshed イベント
• 更新を防止するための Cancel プロパティ
• プル距離を追跡するための Progress プロパティ
• イベント処理のパターンと例