Skip to content

ColorPicker 颜色选择器 ​

用于选择和设置颜色。支持多种色彩模式(HEX, RGB, HSL),具备透明度控制及预定义色彩等高级特性。

展示模式 ​

ColorPicker 提供全功能的交互演示,您可以实时切换透明度支持和不同尺寸。

全功能展示

基础用法 ​

颜色选择器的基础功能,支持 HEX 格式的双向绑定。

基础用法

透明度调节 ​

开启 show-alpha 属性后,组件将支持 alpha 通道的调节,并自动切换为 RGBA 格式。

支持透明度

预定义色彩 ​

可以在面板底部显示一系列预设的快速颜色选项。

预定义颜色

禁用状态 ​

设置 disabled 属性后颜色选择器将无法进行交互。

禁用状态

自创高级特性 ​

1. 智能对比度预览 (Intelligent Contrast) ​

组件面板会自动根据 WCAG 标准 计算选中颜色与背景的相对亮度,并在右上角实时给出辅助功能建议,确保设计方案满足视觉无障碍要求。

2. 跨平台吸色器 (EyeDropper) ​

基于现代浏览器原生的 EyeDropper API,支持从屏幕任何位置获取颜色(不仅限于浏览器窗口内),为专业设计场景提供生产力级支持。

3. 双向交互输入框 ​

底部的值显示区域现已升级为感应式输入框。您可以直接粘贴设计师提供的 HEX 或 RGB 代码,组件会瞬间解析定位。

在 Nuxt 中使用 ​

YhColorPicker 已完美适配 Nuxt 3/4。在 Nuxt 架构下,所有相关 API(包括 EyeDropper 检测)均经过了 Client-Only 环境优化,确保 SSR 流程零报警。

Nuxt 中使用

API ​

Props ​

属性名说明类型默认值
v-model绑定值string—
show-alpha是否支持透明度booleanfalse
predefine预定义颜色列表string[][]
size尺寸'large' | 'default' | 'small''default'
disabled是否禁用booleanfalse
popper-class面板自定义类名string—
theme-overrides组件级主题覆盖ComponentThemeVarsundefined

Events ​

事件名说明参数
change确定选择颜色时触发(val: string)
active-change面板内颜色实时改变时触发(val: string)

主题变量 ​

变量名说明默认值
--yh-color-picker-width组件基础宽度60px
--yh-color-picker-panel-width展开面板宽度280px
--yh-color-picker-border-radius圆角弧度12px

类型导出 ​

名称说明
YhColorPickerPropsYhColorPicker props 类型
YhColorPickerEmitsYhColorPicker emits 类型
YhColorPickerSlotsYhColorPicker slots 类型
YhColorPickerExposeYhColorPicker expose 类型
YhColorPickerInstanceYhColorPicker 实例类型

Slots ​

当前组件未暴露组件插槽。

Expose ​

名称说明类型
visible当前面板显示状态。Ref<boolean>
togglePopper切换面板展开状态。() => void
handleClear清空当前颜色值。() => void
handleConfirm确认当前颜色值。() => void

Released under the MIT License.