syncfusion-maui-theming

Syncfusion .NET MAUI のテーマ設定

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

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

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

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

コンポーネントの概要

Syncfusion のテーマ設定システムでは、SyncfusionThemeResourceDictionary を通じてすべての MAUI コンポーネントのスタイルを統一的に設定できます。この一元化された方式には、次のようなメリットがあります。

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

使用可能なテーマ：

• MaterialLight - Material Design のライトテーマ
• MaterialDark - Material Design のダークテーマ
• CupertinoLight - Apple iOS のライトテーマ
• CupertinoDark - Apple iOS のダークテーマ

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

基本的なテーマ設定

📄 参照： references/applying-themes.md

• SyncfusionThemeResourceDictionary のインストールと構成
• 使用可能なテーマのオプション（Material、Cupertino）
• 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}
• カテゴリ別の一般的なコントロールキー
• 任意のコントロールのキーを見つける方法
• 公式ドキュメントへの参照