---
url: /components/color-picker.md
---
# ColorPicker 颜色选择器

取色器：饱和度/色相面板 + 预设色板，支持透明度通道；主题定制后台的常用输入件。

## 基础用法

## 预设色板与透明度

`predefine` 提供快捷色块；`show-alpha` 开启透明通道（绑定值变为 rgba）：

## 实时取值

拖动面板过程中 `active-change` 持续回传当前色（此时还未写入 `v-model`），适合联动预览；松手或点确定才提交：

## 写入格式

`color-format` 指定写回格式（hex / rgb / hsl / hexa / hsla / rgba），未指定时按 `show-alpha` 自动在 hex 与 rgba 间切换：

## 禁用与尺寸

`disabled` 后触发钮不可点击；`size` 独立设置，缺省跟随 Form 注入：