Color Picker 颜色选择器
用于选择颜色,支持多种颜色格式。
基础用法
需将 v-model 绑定为字符串类型的变量。
With default value
With no default value
透明度
支持选择带透明度的颜色,设置 show-alpha 即可启用 Alpha 滑块。
预定义颜色
可通过 predefine 传入预置颜色列表。
尺寸
API
属性
| 名称 | 说明 | 类型 | 默认值 |
|---|---|---|---|
| model-value / v-model | 绑定值 | string | — |
| disabled | 是否禁用 | boolean | false |
| clearable | 是否显示清空按钮 | boolean | true |
| size | 组件尺寸 | enum | — |
| show-alpha | 是否展示透明度滑块 | boolean | false |
| color-format | v-model 的颜色格式 | enum | enum |
| popper-class | 下拉弹层的自定义类名 | string / object | '' |
| popper-style | 下拉弹层的自定义样式 | string / object | — |
| predefine | 预定义颜色 | array | — |
| validate-event | 是否触发表单校验 | boolean | true |
| tabindex | 原生 tabindex | string / number | 0 |
| aria-label a11y | 无障碍 aria-label | string | — |
| empty-values | 视为空的取值,参见 config-provider | array | — |
| value-on-clear | 清空后的返回值,参见 config-provider | string / number / boolean / Function | — |
| id | 原生 id | string | — |
| teleported | 是否将弹层挂载到 body | boolean | true |
| persistent | 关闭且 persistent 为 false 时是否销毁面板 | boolean | true |
| append-to | 面板挂载到的目标元素 | CSSSelector / HTMLElement | - |
事件
| 名称 | 说明 | 类型 |
|---|---|---|
| change | 绑定值变化时触发 | Function |
| active-change | 当前激活颜色变化时触发 | Function |
| focus | 获得焦点时触发 | Function |
| blur | 失去焦点时触发 | Function |
| clear | 点击清空按钮时触发 | Function |
暴露
| 名称 | 说明 | 类型 |
|---|---|---|
| color | 当前颜色对象 | object |
| show | 手动打开颜色选择器 | Function |
| hide | 手动关闭颜色选择器 | Function |
| focus | 聚焦触发器元素 | Function |
| blur | 使触发器失焦 | Function |