项目正在快速迭代中,API 与视觉细节可能随版本调整,请勿用于生产环境。
仅桌面端保证样式

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开启透明度通道booleanfalse
color-format写回格式:hex / rgb / hsl / hexa / hsla / rgba,缺省时按 show-alpha 自动取 hex 或 rgbastring
popper-class弹层面板附加类名(深度定制弹层样式时用)string
size尺寸(缺省跟随 Form)large | default | smalldefault
disabled禁用booleanfalse
validate-event接入 Form 时触发校验booleantrue

ColorPicker Events

参数说明类型默认值
update:modelValue / change值变更(拖拽结束或确认时提交)(value: string) => void—
active-change面板内拖动过程中的实时取值(value: string) => void—

ColorPicker Methods

参数说明类型默认值
show打开取色面板() => void—
hide关闭取色面板() => void—
focus聚焦触发钮() => void—
blur失焦触发钮() => void—