syncfusion-maui-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によるデータバインディング
• 包括的なイベント処理
• 最新のリキッドグラス効果（.NET 10以降）

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

はじめに

📄 参照： references/getting-started.md

次のようなニーズがある場合は、このリファレンスを参照してください。

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

カードビューの機能

📄 参照： references/card-views.md

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

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

カードレイアウトの機能

📄 参照： 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 イベント（カードが変わる前のイベント。キャンセルに対応）
• VisibleIndexChanged イベント（カードが変わった後のイベント）
• Dismissing イベント（閉じる前のイベント。キャンセルに対応）
• Dismissed イベント（閉じる処理の完了後のイベント）
• イベントハンドラーの実装とシナリオ

Liquid Glass エフェクト

📄 参照： references/liquid-glass-effect.md

以下を実現したい場合は、このリファレンスを参照してください。

• モダンな半透明のガラスエフェクト
• EnableLiquidGlassEffect プロパティの使用方法
• プラットフォーム要件（macOS 26+、iOS 26+、.NET 10）
• ガラスの外観にするための背景設定
• 洗練されたモダンなカードデザイン