Skip to content

ColorPicker 颜色选择器

用于颜色选择,支持多种格式、透明度、吸管工具及色彩和谐推荐。

基础用法

使用 v-model 绑定颜色值。

选择透明度

ColorPicker 支持普通颜色,也支持带 Alpha 通道的颜色。

通过设置 show-alpha 属性开启透明度选择。

预定义颜色

predefine 属性允许你传入一个颜色数组,作为预定义颜色供用户选择。

不同尺寸

吸管工具与色彩和谐 (特色功能)

支持浏览器原生吸管工具(EyeDropper API)以及自动生成色彩和谐推荐(补色、三色、类比色)。

设置 show-harmony 开启色彩推荐,enable-eye-dropper 开启吸管(需浏览器支持)。

ColorPicker 属性

属性名说明类型默认值
model-value / v-model绑定值string
disabled是否禁用booleanfalse
size尺寸stringdefault
show-alpha是否支持透明度选择booleanfalse
color-format写入 v-model 的颜色格式stringhex (hex / rgb / hsl / hsv)
popper-classColorPicker 下拉框的类名string
predefine预定义颜色array
show-harmony是否显示色彩和谐推荐(补色、类比色等)booleanfalse
enable-eye-dropper是否启用吸管工具 (需要浏览器支持 EyeDropper API)booleantrue

ColorPicker 事件

事件名说明参数
change当绑定值变化时触发value
active-change面板中当前显示的颜色发生改变时触发value