• ColorPicker 颜色选择器
    • 概述
    • 代码示例
    • API
      • ColorPicker props
      • ColorPicker events

    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