syncfusion-maui-toolkit-bottom-sheet

.NET MAUI ボトムシート（SfBottomSheet）

概要

ボトムシートは、画面下部からスライドして表示されるユーザーインターフェースコンポーネントです。メイン画面から移動せずに、追加情報や操作を利用できます。Syncfusion の SfBottomSheet コントロールは、.NET MAUI アプリケーション向けに、包括的な状態管理、コンテンツ設定、ジェスチャー対応、幅広いカスタマイズオプションを提供します。

主な機能：

• 複数の状態：FullExpanded、HalfExpanded、Collapsed、Hidden
• データバインディングに対応した柔軟なコンテンツ設定
• タッチジェスチャー：スワイプによる展開／折りたたみ
• 幅広いカスタマイズ：色、サイズ、角の半径、パディング、グラバーのスタイル
• イベント処理と状態変更の通知
• モーダル表示と非モーダル表示
• IsOpen プロパティおよび Show／Close メソッドによるプログラム制御

---

このスキルの使用場面

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

• ページ全体を移動せずに補足コンテンツを表示する（商品詳細、情報パネル、設定など）
• リストの選択項目を詳細なコンテンツビューにバインドする、データ駆動型のインタラクションを作成する
• メインコンテンツに重ねて表示するモーダルダイアログや確認用シートを実装する
• ユーザーがコンテンツを段階的に展開できる、部分表示パターンを提供する（ちら見せ効果）
• スワイプして詳細情報を表示できる、ジェスチャーベースの UI を実現する
• アプリケーションのテーマに合わせて外観をカスタマイズする（色、サイズ、角の丸み、アニメーション）
• プログラムによる操作やユーザー操作を通じて状態遷移を処理する
• モバイルファーストのアプリケーションでフォーカスとオーバーレイの動作を管理する

---

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

はじめに

📄 参照： references/getting-started.md

• プロジェクトのセットアップとテンプレートの作成
• NuGet パッケージのインストール（Syncfusion.Maui.Toolkit）
• MauiProgram.cs でのハンドラー登録
• 基本的なコントロールの初期化
• ListView との連携を含む、最初の動作するサンプル

コンテンツの設定

📄 参照： references/content-configuration.md

• メインコンテンツとボトムシートコンテンツの設定
• ViewModel を使用したデータバインディング
• レイアウトパターン（VerticalStackLayout、Grid、ListView）
• 動的なコンテンツの更新
• バインディングコンテキストの管理

状態と状態管理

📄 参照： references/states-management.md

• 状態プロパティの値と遷移
• AllowedState の設定（FullExpanded、HalfExpanded、All）
• プログラム制御用の IsOpen プロパティ
• 状態変更のシナリオと使用例

カスタマイズとスタイル設定

📄 参照： references/customization-styling.md

• ポップアップモード（IsModal）とオーバーレイの動作
• 背景色と角の半径
• 高さの調整（FullExpandedRatio、HalfExpandedRatio、CollapsedHeight）
• 幅のモード（Full、Custom）
• コンテンツのパディングと間隔
• グラバー要素のカスタマイズ
• アニメーション時間の設定

ジェスチャー、イベント、メソッド

📄 参照： references/gestures-events-methods.md

• スワイプジェスチャーへの対応（EnableSwiping）
• StateChanged イベントの処理
• オーバーレイ操作用の CollapseOnOverlayTap
• プログラム制御用の Show／Close メソッド
• イベント引数の確認

よくあるパターンと実際の使用例

📄 参照： references/common-patterns.md

• リスト選択を使ったデータ駆動型ボトムシート
• モーダルダイアログと確認用シート
• 部分表示とちら見せのパターン
• 動的なコンテンツのバインディング
• エラー処理とエッジケース
• ベストプラクティスとアンチパターン

---