Skip to content

ColorPicker 颜色选择器 ​

用于颜色选择,支持多种格式。

ts
import { createApp } from 'vue'
import { ElColorPicker } from '@szhn/dh-design-pc'

const app = createApp()
app.use(ElColorPicker)

基础用法 ​

选择透明度 ​

预定义颜色 ​

不同尺寸 ​

禁用状态 ​

通过 disabled 属性禁用颜色选择器。

输出不同的格式 ​

通过 color-format 指定 v-model 的输出格式,可选值为 hex、rgb、hsl、hsv。

API ​

Attributes ​

属性名说明类型默认值
model-value / v-model选中项绑定值string—
disabled是否禁用booleanfalse
clearable文本框可输入booleantrue
size尺寸enum—
show-alpha是否支持透明度选择booleanfalse
color-format写入 v-model 的颜色的格式enumenum
popper-classColorPicker 下拉框的类名string / object''
popper-styleColorPicker 下拉面板的自定义样式string / object—
predefine预定义颜色array—
validate-event输入时是否触发表单的校验booleantrue
tabindexColorPicker 的 tabindexstring / number0
aria-label a11yColorPicker 的 aria-labelstring—
empty-values组件的空值配置, 参考config-providerarray—
value-on-clear清空选项的值, 参考config-providerstring / number / boolean / Function—
idColorPicker 的 idstring—
teleported是否将 popover 的下拉列表渲染至 body 下booleantrue
label a11y deprecatedColorPicker 的 aria-labelstring—
persistent当颜色选择器未激活且 persistent 为 false 时,颜色面板将被销毁。booleantrue
append-to挂载到哪个 DOM 元素CSSSelector / HTMLElement-

Events ​

事件名说明类型
change当绑定值变化时触发Function
active-change面板中当前显示的颜色发生改变时触发Function
focus当获得焦点时触发Function
blur当失去焦点时触发Function
clear当点击清除按钮时触发Function

Exposes ​

名称说明类型
color当前色彩对象object
show手动显示颜色选择器Function
hide手动隐藏颜色选择器Function
focus使 picker 获得焦点Function
blur使 picker 失去焦点Function