仅桌面端保证样式
ColorPicker 颜色选择器
取色器:饱和度/色相面板 + 预设色板,支持透明度通道;主题定制后台的常用输入件。
基础用法
当前值:#175DFF
预设色板与透明度
predefine 提供快捷色块;show-alpha 开启透明通道(绑定值变为 rgba):
透明通道值:rgba(23, 93, 255, 0.6)
实时取值
拖动面板过程中 active-change 持续回传当前色(此时还未写入 v-model),适合联动预览;松手或点确定才提交:
实时值:未拖动面板
写入格式
color-format 指定写回格式(hex / rgb / hsl / hexa / hsla / rgba),未指定时按 show-alpha 自动在 hex 与 rgba 间切换:
rgb:#175DFF
hsl:#10B981
hexa:#175DFF99
禁用与尺寸
disabled 后触发钮不可点击;size 独立设置,缺省跟随 Form 注入:
ColorPicker Props
| 参数 | 说明 | 类型 | 默认值 |
|---|---|---|---|
| modelValue | 绑定值(十六进制或 rgba 字符串) | string | |
| predefine | 预设色板 | string[] | [] |
| show-alpha | 开启透明度通道 | boolean | false |
| color-format | 写回格式:hex / rgb / hsl / hexa / hsla / rgba,缺省时按 show-alpha 自动取 hex 或 rgba | string | |
| popper-class | 弹层面板附加类名(深度定制弹层样式时用) | string | |
| size | 尺寸(缺省跟随 Form) | large | default | small | default |
| disabled | 禁用 | boolean | false |
| validate-event | 接入 Form 时触发校验 | boolean | true |
ColorPicker Events
| 参数 | 说明 | 类型 | 默认值 |
|---|---|---|---|
| update:modelValue / change | 值变更(拖拽结束或确认时提交) | (value: string) => void | — |
| active-change | 面板内拖动过程中的实时取值 | (value: string) => void | — |
ColorPicker Methods
| 参数 | 说明 | 类型 | 默认值 |
|---|---|---|---|
| show | 打开取色面板 | () => void | — |
| hide | 关闭取色面板 | () => void | — |
| focus | 聚焦触发钮 | () => void | — |
| blur | 失焦触发钮 | () => void | — |