syncfusion-maui-color-picker

.NET MAUI 颜色选取器实现

全面介绍如何实现和自定义 Syncfusion .NET MAUI 颜色选取器（SfColorPicker）控件。此控件支持用户从调色板网格或色谱渐变中选择颜色，并支持自定义颜色、最近使用的颜色、Alpha 透明度和多种显示模式。

何时使用此技能

在以下情况下使用此技能：

• 安装并设置 Syncfusion .NET MAUI 颜色选取器
• 在 .NET MAUI 应用程序中实现颜色选择 UI
• 在调色板和色谱颜色模式之间切换
• 自定义颜色选取器的外观（调色板、滑块、按钮）
• 将颜色选取器以内嵌或弹出式/下拉式方式显示
• 处理颜色选择事件（ColorChanging、ColorChanged、ColorSelected）
• 配置最近使用的颜色面板和自定义颜色集合
• 实现颜色的 Alpha/不透明度控制
• 自定义显示视图（图标、模板、下拉按钮）
• 为不同区域设置添加本地化支持
• 启用现代 Liquid Glass 效果（.NET 10+）
• 排查颜色选取器实现问题

组件概述

SfColorPicker 是一款多功能颜色选择控件，提供以下功能：

• 两种颜色模式：调色板（预定义颜色网格）和色谱（基于渐变的选择）
• 自定义颜色：向调色板添加或移除自定义颜色
• 最近使用的颜色：自动记录最近选择的颜色
• Alpha 控制：通过 Alpha 滑块调整透明度
• 手动输入：直接输入颜色值（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

• 输入区域的可见性
• Alpha 滑块配置
• 操作按钮（应用/取消）的可见性和样式
• 按钮背景和标签样式
• 最近使用的颜色和色谱输入视图标签样式
• 调色板自定义（行数/列数、间距、单元格形状、大小、圆角半径）
• 自定义调色板颜色（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）
• 视觉提示与最佳实践