syncfusion-maui-color-picker

.NET MAUI カラーピッカーの実装

Syncfusion .NET MAUI カラーピッカー（SfColorPicker）コントロールを実装およびカスタマイズするための包括的なスキルです。このコントロールを使用すると、パレットのグリッドまたはスペクトルのグラデーションから色を選択できます。また、カスタムカラー、最近使用した色、アルファ透明度、複数の表示モードにも対応しています。

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

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

• Syncfusion .NET MAUI カラーピッカーをインストールしてセットアップする
• .NET MAUI アプリケーションに色選択 UI を実装する
• パレットモードとスペクトルモードを切り替える
• カラーピッカーの外観（パレット、スライダー、ボタン）をカスタマイズする
• カラーピッカーをインラインまたはポップアップ／ドロップダウンとして表示する
• 色選択イベント（ColorChanging、ColorChanged、ColorSelected）を処理する
• 最近使用した色のパネルとカスタムカラーコレクションを設定する
• 色のアルファ値／不透明度の制御を実装する
• 表示ビュー（アイコン、テンプレート、ドロップダウンボタン）をカスタマイズする
• さまざまなカルチャ向けのローカライズに対応する
• 最新の Liquid Glass 効果を有効にする（.NET 10 以降）
• カラーピッカーの実装に関する問題をトラブルシューティングする

コンポーネントの概要

SfColorPicker は、次の機能を備えた多用途の色選択コントロールです。

• 2 つのカラーモード：パレット（事前定義された色のグリッド）とスペクトル（グラデーションベースの選択）
• カスタムカラー：パレットへのカスタムカラーの追加／削除
• 最近使用した色：最近選択した色を自動的に記録
• アルファ値の制御：アルファスライダーによる透明度の調整
• 手動入力：色の値を直接入力（RGB、HSV、HEX 形式）
• インラインモードとポップアップモード：レイアウトに直接埋め込むか、ドロップダウンとして表示
• 色なしオプション：ユーザーが色の選択を解除／クリアできるようにする
• 豊富なカスタマイズ：パレット、スライダー、ボタン、インジケーターの幅広いスタイル設定
• ローカライズ：リソースファイルによる多言語対応
• 最新の効果：Liquid Glass／Acrylic の視覚効果（.NET 10 以降）

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

はじめに

📄 参照先： references/getting-started.md

• NuGet パッケージによるインストール
• MauiProgram.cs でのハンドラー登録
• SfColorPicker の基本的な実装（XAML と C#）
• 最初に動作するカラーピッカーの例

カラーモードと選択

📄 参照先： references/modes-and-selection.md

• ColorMode プロパティ（パレットとスペクトル）
• SelectedColor の既定値の設定
• カラーモード切り替え機能の表示／非表示
• 最近使用した色のパネル（ShowRecentColors）
• ClearRecentColors メソッド
• ShowNoColor オプション

カスタマイズ

📄 参照先： references/customization.md

• 入力領域の表示／非表示
• アルファスライダーの設定
• アクションボタン（適用／キャンセル）の表示設定とスタイル設定
• ボタンの背景とラベルのスタイル
• 最近使用した色とスペクトル入力ビューのラベルスタイル
• パレットのカスタマイズ（行数／列数、間隔、セルの形状、サイズ、角の半径）
• カスタムパレットカラー（PaletteColors）
• 選択インジケーターのカスタマイズ（半径、ストローク、太さ）
• スライダーのつまみのカスタマイズ（塗りつぶし、半径、ストローク、太さ）
• ポップアップのカスタマイズ（IsOpen、背景、相対位置）

表示ビューのカスタマイズ

📄 参照先： references/display-view.md

• 選択色アイコン（SelectedColorIcon）
• 選択色アイコンのサイズ
• 選択色テンプレート（SelectedColorTemplate）
• ドロップダウンボタンテンプレート（DropDownButtonTemplate）
• 表示ビューの高さ、ストローク、ストロークの太さ
• ドロップダウンボタンの幅

インライン表示

📄 参照先： references/inline-rendering.md

• IsInline プロパティ
• インラインモードとポップアップモードの使い分け
• インラインカラーピッカーの実装
• 埋め込み型カラーピッカーのユースケース

イベントと操作

📄 参照: references/events-and-interaction.md

• ColorChanging イベント（キャンセルに対応）
• ColorChanged イベント（アクションボタンの動作）
• ColorSelected イベント
• ColorChangedCommand
• イベント引数とプロパティ
• UI 更新を含む実用例

高度な機能

📄 参照: references/advanced-features.md

• ローカライズの設定と構成
• CurrentUICulture の設定
• リソースファイルの構成
• Liquid Glass 効果（EnableLiquidGlassEffect）
• プラットフォーム要件（.NET 10+、iOS 26、macOS 26）
• 見た目に関するヒントとベストプラクティス