syncfusion-maui-toolkit-theming

Syncfusion .NET MAUI のテーマ設定

すべての Syncfusion .NET MAUI コンポーネントにテーマを適用、カスタマイズ、作成するための完全ガイドです。

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

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

• ライトテーマまたはダークテーマ（MaterialLight、MaterialDark）を適用する
• アプリケーションで SyncfusionThemeResourceDictionary を構成する
• 実行時にテーマを動的に切り替える
• 特定のコントロールのデフォルトテーマカラーを上書きする
• コントロール固有のスタイルや外観をカスタマイズする
• 独自のテーマを一から作成する
• すべてのコンポーネントに一貫したブランド設定を適用する
• システムテーマとの同期を実装する
• テーマに関連するスタイルの問題をトラブルシューティングする
• 特定の UI 要素のテーマキーを探す

コンポーネントの概要

Syncfusion のテーマ設定システムでは、SyncfusionThemeResourceDictionary を使用して、すべての MAUI コンポーネントに統一的にスタイルを設定できます。この一元化されたアプローチには、次の利点があります。

• 自動マージ：コントロール固有のスタイルが自動的に含まれます
• 一貫した外観：すべてのコンポーネントで統一された見た目になります
• 簡単なテーマ切り替え：実行時にテーマを変更できます
• 柔軟なカスタマイズ：特定のキーを上書きするか、カスタムテーマを作成できます
• プラットフォームテーマ：Material Design に対応しています

使用可能なテーマ：

• MaterialLight - Material Design のライトテーマ
• MaterialDark - Material Design のダークテーマ

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

基本的なテーマ設定

📄 参照： references/applying-themes.md

• SyncfusionThemeResourceDictionary のインストールと構成
• 使用可能なテーマのオプション（Material）
• App.xaml でのテーマ設定
• コントロールスタイルの自動マージ
• プラットフォーム固有のテーマ適用
• VisualTheme プロパティの使用

実行時のテーマ切り替え

📄 参照： references/theme-switching.md

• 実行時のテーマの動的な変更
• テーマ管理のための ViewModel パターン
• テーマディクショナリの削除と追加
• ユーザー設定の永続化
• システム／OS テーマとの同期
• エッジケースとトラブルシューティング

デフォルトテーマのカスタマイズ

📄 参照： references/overriding-themes.md

• 特定のテーマカラーキーの上書き
• コントロール固有のキーのカスタマイズ
• プライマリキーとコントロール固有キー
• マージされたディクショナリのレイヤー順序
• 選択的なカスタマイズ戦略
• 一般的なブランド設定のシナリオ

カスタムテーマの作成

📄 参照： references/creating-custom-themes.md

• テーマを一から作成する
• テーマキーの登録パターン
• カスタム配色の定義
• テーマの完全な実装
• 企業のブランド設定テーマ
• アクセシビリティ対応テーマ（ハイコントラスト）

テーマキーのリファレンス

📄 参照： references/theme-keys-reference.md

• キーの命名規則
• 構造：Sf{ControlName}{Element}{Property}
• カテゴリ別の一般的なコントロールキー
• 任意のコントロールのキーを探す方法
• 公式ドキュメントへの参照