Skip to content

ColorPicker 颜色选择器

使用

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

TIP

SSR 场景下,您需要将组件包裹在 <client-only></client-only> 之中 (如: Nuxt) 和 SSG (e.g: VitePress).

基础用法

使用 v-modelVue 实例中的一个变量进行双向绑定,绑定的变量需要是字符串类型。

选择透明度

ColorPicker 支持普通颜色,也支持带 Alpha 通道的颜色,通过show-alpha属性即可控制是否支持透明度的选择。 要启用 Alpha 选择,只需添加 show-alpha 属性。

预定义颜色

ColorPicker 支持预定义颜色

不同尺寸

API

Props

参数名描述类型默认值
model-value / v-model选中项绑定值string-
disabled是否禁用booleanfalse
size尺寸enum-
show-alpha是否支持透明度选择booleanfalse
color-format写入 v-model 的颜色的格式enum-
popper-classColorPicker 下拉框的类名string-
predefine预定义颜色object-
validate-event输入时是否触发表单的校验booleantrue
tabindexColorPicker 的 tabindexstring / number0
label a11yColorPicker 的 aria-labelstring-
idColorPicker 的 idstring-

Events

事件名描述类型
change当绑定值变化时触发Function
active-change面板中当前显示的颜色发生改变时触发Function
focus当获得焦点时触发Function
blur当失去焦点时触发Function

Methods

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