ColorPicker 颜色选择器

概述

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

代码示例

ColorPicker 颜色选择器 - 图1

基础用法

基本用法,可以使用 v-model 实现数据的双向绑定。

  1. <template>
  2. <Row>
  3. <Col span="12">
  4. 有默认值
  5. <ColorPicker v-model="color1" />
  6. </Col>
  7. <Col span="12">
  8. 无默认值
  9. <ColorPicker v-model="color2" />
  10. </Col>
  11. </Row>
  12. </template>
  13. <script>
  14. export default {
  15. data () {
  16. return {
  17. color1: '#19be6b',
  18. color2: ''
  19. }
  20. }
  21. }
  22. </script>

ColorPicker 颜色选择器 - 图2

透明度

开启属性 alpha,可以选择带 Alpha 通道的颜色。

  1. <template>
  2. <ColorPicker v-model="color3" alpha />
  3. </template>
  4. <script>
  5. export default {
  6. data () {
  7. return {
  8. color3: 'rgba(25, 190,107, .5)'
  9. }
  10. }
  11. }
  12. </script>

ColorPicker 颜色选择器 - 图3

色彩

设置属性 hue 为 false,可以禁用色彩选项。

<template>
    <ColorPicker v-model="color7" :hue="false" />
</template>
<script>
    export default {
        data () {
            return {
                color7: '#19be6b'
            }
        }
    }
</script>

ColorPicker 颜色选择器 - 图4

颜色预设

开启属性 recommend 可以显示推荐的颜色预设,或设置属性 colors 来自定义预设颜色。

<template>
    <Row>
        <Col span="12">
            <ColorPicker v-model="color4" recommend />
        </Col>
        <Col span="12">
            <ColorPicker v-model="color5" :colors="colors" />
        </Col>
    </Row>
</template>
<script>
    export default {
        data () {
            return {
                color4: '#19be6b',
                color5: '#19be6b',
                colors: ['#311B92', '#512DA8', '#673AB7', '#9575CD', '#D1C4E9']
            }
        }
    }
</script>

ColorPicker 颜色选择器 - 图5

尺寸

选择器有三种尺寸:大、默认(中)、小。

<template>
    <Row>
        <Col span="8">
            <ColorPicker v-model="color6" size="large" />
        </Col>
        <Col span="8">
            <ColorPicker v-model="color6" />
        </Col>
        <Col span="8">
            <ColorPicker v-model="color6" size="small" />
        </Col>
    </Row>
</template>
<script>
    export default {
        data () {
            return {
                color6: '#19be6b'
            }
        }
    }
</script>

API

ColorPicker props

属性说明类型默认值
value绑定的值,可使用 v-model 双向绑定String-
disabled是否禁用Booleanfalse
editable是否可以输入色值Booleantrue
alpha是否支持透明度选择Booleanfalse
hue是否支持色彩选择Booleantrue
recommend是否显示推荐的颜色预设Booleanfalse
colors自定义颜色预设Array[]
format颜色的格式,可选值为 hsl、hsv、hex、rgbString开启 alpha 时为 rgb,其它为 hex
size尺寸,可选值为largesmalldefault或者不设置String-
capture 4.0.0是否开启 capture 模式,也可通过全局配置Booleantrue

ColorPicker events

事件名说明返回值
on-change当绑定值变化时触发当前值
on-active-change面板中当前显示的颜色发生改变时触发当前显示的颜色值
on-open-change下拉框展开或收起时触发true / false