syncfusion-maui-toolkit-cards

.NET MAUI Cards（SfCards）の実装

Syncfusion .NET MAUI Cards コントロールは、スワイプで閉じられる単一カードビュー（SfCardView）と、スワイプ可能なカードスタック（SfCardLayout）の両方を提供します。このスキルでは、インストール、カードの作成、スワイプジェスチャ、カスタマイズ、データバインディング、イベント、最新の視覚効果について説明します。

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

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

• 閉じられるカードビューを作成する - 左右にスワイプして閉じられる単一カード
• カードスタックを構築する - スワイプで切り替えられる、複数のカードを重ねた表示
• スワイプジェスチャを実装する - 左、右、上、下の4方向へのスワイプに応答するカード
• カードベースの UI を表示する - コンテンツを整理するためのビジュアルカードコンテナー
• インタラクティブなカードを追加する - タップイベント、閉じるイベント、状態管理に対応したカード
• カードにデータをバインドする - BindableLayout を使用して、データコレクションからカードを動的に生成する
• カードの外観をカスタマイズする - 境界線、角、インジケーター、色
• カードイベントを処理する - Tapped、dismissing、dismissed、index changing イベント

このスキルは Syncfusion の .NET MAUI Cards コントロール（SfCardView と SfCardLayout）専用です。汎用的なカードレイアウトや、その他のカードライブラリは対象外です。

コンポーネントの概要

Syncfusion .NET MAUI Cards コントロールは、次の2つの主要コンポーネントを提供します。

1. SfCardView - スワイプで閉じられる単一カード（任意）
2. SfCardLayout - 複数の SfCardView アイテムを重ね、スワイプで切り替えるためのコンテナー

主な機能：

• スワイプして閉じる機能
• 複数方向へのスワイプに対応（左、右、上、下）
• 外観のカスタマイズ（境界線、角、インジケーター）
• プログラムによるカードの閉鎖
• BindableLayout によるデータバインディング
• 包括的なイベント処理

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

はじめに

📄 参照： references/getting-started.md

次のような場合に、このリファレンスを参照してください。

• Syncfusion.Maui.Toolkit NuGet パッケージをインストールする
• MauiProgram.cs で Syncfusion ハンドラーを登録する（ConfigureSyncfusionToolkit）
• 最初の SfCardView を作成する
• 基本的な XAML と C# の実装パターンを理解する

Card View の機能

📄 参照： references/card-views.md

単一カードを扱い、次のような機能が必要な場合に、このリファレンスを参照してください。

• SfCardView コンポーネントの概要と使用方法
• スワイプして閉じる機能を実現する SwipeToDismiss プロパティ
• プログラムで閉じるための IsDismissed プロパティ
• 視覚効果の FadeOutOnSwiping
• 単一カードの実装パターン
• 単独カードのシナリオ

Card Layout の機能

📄 参照： references/card-layouts.md

次の機能を備えたカードスタックが必要な場合に、このリファレンスを参照してください。

• 複数のカードを重ねて表示する SfCardLayout コンポーネント
• カードの端を表示する ShowSwipedCard プロパティ
• カードを切り替える VisibleIndex プロパティ
• SwipeDirection の設定（Left、Right、Top、Bottom）
• 複数カードの管理
• スワイプジェスチャによるカード間の切り替え

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

📄 参照： references/customization.md

次の項目をカスタマイズする場合に、このリファレンスを参照してください。

• BorderColor、BorderWidth、CornerRadius プロパティ
• 背景色とグラデーション
• インジケーターのカスタマイズ（色、太さ、位置）
• FadeOutOnSwiping 効果
• 高度なビジュアルスタイル設定
• カスタムカードデザインとテーマ

BindableLayout によるデータバインディング

📄 参照： references/data-binding.md

次のようなことが必要な場合に、このリファレンスを参照してください。

• データコレクションからカードを動的に生成する
• SfCardLayout で BindableLayout を使用する
• ViewModel とデータソースを設定する
• ItemsSource と ItemTemplate を構成する
• データ駆動型のカードインターフェイスを作成する
• カードのプロパティをデータモデルにバインドする

イベントとインタラクション

📄 参照先： references/events.md

ユーザーが以下の処理を行う必要がある場合は、このリファレンスを参照してください。

• Tapped イベント（カードのタップ検出）
• VisibleIndexChanging イベント（カード変更前のイベント。Cancel に対応）
• VisibleIndexChanged イベント（カード変更後のイベント）
• Dismissing イベント（閉じる前のイベント。Cancel に対応）
• Dismissed イベント（閉じる処理の完了後のイベント）
• イベントハンドラーの実装とシナリオ