ColorPicker 取色器
ColorPicker 是一种支持多种颜色格式的颜色选择器。
基础用法
ColorPicker 需要绑定一个字符串类型的变量到 v-model。
透明度
ColorPicker 支持透明度选择。 只需要添加 show-alpha 属性即可激活透明度选择。
预定义颜色
ColorPicker 支持预定义颜色选项
尺寸
API
属性
| 名称 | 描述 | 类型 | 默认值 |
|---|---|---|---|
| model-value / v-model | 绑定值 | string | — |
| disabled | 是否禁用取色器 | boolean | false |
| clearable 可清空 2.13.1 | 是否显示清除按钮 | boolean | true |
| size | 取色器的尺寸 | 枚举 | — |
| show-alpha | 是否显示透明度滑块 | boolean | false |
| color-format | v-model 的颜色格式 | 枚举 | 枚举 |
| popper-class | 取色器下拉框的自定义类名 | string / object | '' |
| popper-style 2.11.4 | 取色器下拉框的自定义样式 | string / object | — |
| predefine | 预定义颜色选项 | array | — |
| validate-event | 是否触发表单验证 | boolean | true |
| tabindex | 取色器的 tabindex | string / number | 0 |
| aria-label a11y 2.7.2 | 取色器的 aria-label | string | — |
| empty-values 2.10.3 | 组件的空值,请参阅 config-provider | array | — |
| value-on-clear 2.10.3 | 清空时的返回值,请参阅 config-provider | string / number / boolean / Function | — |
| id | 取色器 id | string | — |
| teleported 2.7.2 | 是否将取色器的弹出框插入至 body | boolean | true |
| label a11y 已废弃 | 取色器的 aria-label | string | — |
| persistent 2.10.5 | 当取色器不活动且 persistent 为 false 时,颜色面板将被销毁 | boolean | true |
| append-to 2.10.5 | 取色器面板追加到哪个元素 | CSSSelector / HTMLElement | - |
事件
| 名称 | 描述 | 类型 |
|---|---|---|
| change | 当输入值变化时触发 | Function |
| active-change | 当前激活颜色变化时触发 | Function |
| focus 2.4.0 | 组件获得焦点时触发 | Function |
| blur 2.4.0 | 组件失去焦点时触发 | Function |
| clear 2.13.1 | 点击清空按钮时触发 | Function |
暴露
| 名称 | 描述 | 类型 |
|---|---|---|
| color | 当前颜色对象 | object |
| show 2.3.3 | 手动显示取色器 | Function |
| hide 2.3.3 | 手动隐藏取色器 | Function |
| focus 2.3.13 | 使取色器获取焦点 | Function |
| blur 2.3.13 | 使取色器失去焦点 | Function |