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,可以禁用色彩选项。

  1. <template>
  2. <ColorPicker v-model="color7" :hue="false" />
  3. </template>
  4. <script>
  5. export default {
  6. data () {
  7. return {
  8. color7: '#19be6b'
  9. }
  10. }
  11. }
  12. </script>

ColorPicker 颜色选择器 - 图4

颜色预设

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

  1. <template>
  2. <Row>
  3. <Col span="12">
  4. <ColorPicker v-model="color4" recommend />
  5. </Col>
  6. <Col span="12">
  7. <ColorPicker v-model="color5" :colors="colors" />
  8. </Col>
  9. </Row>
  10. </template>
  11. <script>
  12. export default {
  13. data () {
  14. return {
  15. color4: '#19be6b',
  16. color5: '#19be6b',
  17. colors: ['#311B92', '#512DA8', '#673AB7', '#9575CD', '#D1C4E9']
  18. }
  19. }
  20. }
  21. </script>

ColorPicker 颜色选择器 - 图5

尺寸

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

  1. <template>
  2. <Row>
  3. <Col span="8">
  4. <ColorPicker v-model="color6" size="large" />
  5. </Col>
  6. <Col span="8">
  7. <ColorPicker v-model="color6" />
  8. </Col>
  9. <Col span="8">
  10. <ColorPicker v-model="color6" size="small" />
  11. </Col>
  12. </Row>
  13. </template>
  14. <script>
  15. export default {
  16. data () {
  17. return {
  18. color6: '#19be6b'
  19. }
  20. }
  21. }
  22. </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-

ColorPicker events

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