Appearance
ColorPicker 颜色选择器
用于颜色选择,支持多种格式、透明度、吸管工具及色彩和谐推荐。
基础用法
使用 v-model 绑定颜色值。
选择透明度
ColorPicker 支持普通颜色,也支持带 Alpha 通道的颜色。
通过设置 show-alpha 属性开启透明度选择。
预定义颜色
predefine 属性允许你传入一个颜色数组,作为预定义颜色供用户选择。
不同尺寸
吸管工具与色彩和谐 (特色功能)
支持浏览器原生吸管工具(EyeDropper API)以及自动生成色彩和谐推荐(补色、三色、类比色)。
设置 show-harmony 开启色彩推荐,enable-eye-dropper 开启吸管(需浏览器支持)。
ColorPicker 属性
| 属性名 | 说明 | 类型 | 默认值 |
|---|---|---|---|
| model-value / v-model | 绑定值 | string | — |
| disabled | 是否禁用 | boolean | false |
| size | 尺寸 | string | default |
| show-alpha | 是否支持透明度选择 | boolean | false |
| color-format | 写入 v-model 的颜色格式 | string | hex (hex / rgb / hsl / hsv) |
| popper-class | ColorPicker 下拉框的类名 | string | — |
| predefine | 预定义颜色 | array | — |
| show-harmony | 是否显示色彩和谐推荐(补色、类比色等) | boolean | false |
| enable-eye-dropper | 是否启用吸管工具 (需要浏览器支持 EyeDropper API) | boolean | true |
ColorPicker 事件
| 事件名 | 说明 | 参数 |
|---|---|---|
| change | 当绑定值变化时触发 | value |
| active-change | 面板中当前显示的颜色发生改变时触发 | value |