ColorPicker 颜色选择器
规则
基础示例
Props 配置示例
渐变模式 / 预设色
禁用
尺寸对比(小 / 中 / 大)
Events 事件示例
value:颜色值(具体类型见 UI 文档 ColorValueType)
Props
| 参数 | 说明 | 类型 | 默认值 | 版本 |
|---|---|---|---|---|
| allowClear | 允许清除 | boolean | false | - |
| arrow | 配置弹出箭头 | boolean | | true | - |
| autoAdjustOverflow | 弹窗不可见时自动调整位置 | boolean | AdjustOverflow | - | - |
| classes | 语义化 class | ColorPickerClassNamesType | - | - |
| defaultFormat | 默认颜色格式 | ColorFormatType | hex | - |
| defaultValue | 默认颜色值 | ColorValueType | - | - |
| destroyOnHidden | 关闭后是否销毁弹窗 | boolean | false | - |
| disabled | 禁用 | boolean | false | - |
| disabledAlpha | 禁用透明度 | boolean | false | - |
| disabledFormat | 禁用格式切换 | boolean | false | - |
| format | 颜色格式,支持 v-model:format | ColorFormatType | - | - |
| getPopupContainer | 弹层挂载节点 | (triggerNode: HTMLElement) => HTMLElement | - | - |
| mode | 单色 / 渐变 | ModeType | ModeType[] | single | - |
| open | 是否显示弹出层,支持 v-model:open | boolean | - | - |
| placement | 弹出位置 | TriggerPlacement | bottomLeft | - |
| presets | 预设颜色 | PresetsItem[] | - | - |
| panelRender | 自定义面板 | (params) => any | - | - |
| rootClass | 根容器 class | string | - | - |
| showText | 显示颜色文本 | boolean | ((params) => any) | false | - |
| size | 触发器大小 | SizeType | middle | - |
| styles | 语义化 style | ColorPickerStylesType | - | - |
| trigger | 触发模式 | TriggerType | click | - |
| valueFormat | 输出值格式 | ColorFormatType | - | - |
| value | 颜色值,支持 v-model:value | ColorValueType | - | - |
Events
| 事件 | 说明 | 类型 | 版本 |
|---|---|---|---|
| change | 颜色变化 | (value: Color, css: string) => void | - |
| clear | 清除 | () => void | - |
| changeComplete | 选择完成 | (value: Color) => void | - |
| openChange | open 变化 | (open: boolean) => void | - |
| formatChange | 格式变化 | (format?: ColorFormatType) => void | - |


