element-ui/examples/docs/en-US/color-picker.md

ColorPicker

ColorPicker is a color selector supporting multiple color formats.

Basic usage

:::demo ColorPicker requires a string typed variable to be bound to v-model.

<div class="block">
  <span class="demonstration">With default value</span>
  <el-color-picker v-model="color1"></el-color-picker>
</div>
<div class="block">
  <span class="demonstration">With no default value</span>
  <el-color-picker v-model="color2"></el-color-picker>
</div>

<script>
  export default {
    data() {
      return {
        color1: '#409EFF',
        color2: null
      }
    }
  };
</script>

:::

Alpha

:::demo ColorPicker supports alpha channel selecting. To activate alpha selecting, just add the show-alpha attribute.

<el-color-picker v-model="color3" show-alpha></el-color-picker>

<script>
  export default {
    data() {
      return {
        color3: 'rgba(19, 206, 102, 0.8)'
      }
    }
  };
</script>

:::

Predefine colors

:::demo ColorPicker supports predefine colors

<el-color-picker v-model="color5" show-alpha :predefine="predefineColors"></el-color-picker>

<script>
  export default {
    data() {
      return {
        color5: 'hsva(180, 65, 20, 0.5)',
        predefineColors: [
          'rgba(19, 206, 102, 0.18)',
          'rgb(25, 159, 147)',
          'hsv(250, 54, 98)',
          'hsva(180, 65, 20, 0.5)',
          'hsl(170, 32%, 87%)',
          'hsla(45, 62%, 47%, 0.13)',
          '#7486de',
          '#45aa9477',
          '#892345'
        ]
      }
    }
  };
</script>

:::

Sizes

:::demo

<el-color-picker v-model="color4"></el-color-picker>
<el-color-picker v-model="color4" size="medium"></el-color-picker>
<el-color-picker v-model="color4" size="small"></el-color-picker>
<el-color-picker v-model="color4" size="mini"></el-color-picker>

<script>
  export default {
    data() {
      return {
        color4: '#409EFF'
      }
    }
  };
</script>

:::

Attributes

Attribute	Description	Type	Accepted Values	Default
disabled	whether to disable the ColorPicker	boolean	—	false
size	size of ColorPicker	string	—	medium / small / mini
show-alpha	whether to display the alpha slider	boolean	—	false
color-format	color format of v-model	string	hsl / hsv / hex / rgb	hex (when show-alpha is false)/ rgb (when show-alpha is true)
popper-class	custom class name for ColorPicker's dropdown	string	—	—
predefine	predefine some colors	array	—	—

Events

Event Name	Description	Parameters
change	triggers when input value changes	color value
active-change	triggers when the current active color changes	active color value