ColorPicker 颜色选择器

ColorPicker 颜色选择器

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

基础用法

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

<template>
  <div class="demo-color-block">
    <span class="demonstration">With default value</span>
    <el-color-picker v-model="color1" />
  </div>
  <div class="demo-color-block">
    <span class="demonstration">With no default value</span>
    <el-color-picker v-model="color2" />
  </div>
</template>
<script lang="ts" setup>
import { ref } from 'vue'
const color1 = ref('#409EFF')
const color2 = ref()
</script>
<style>
.demo-color-block {
  display: flex;
  align-items: center;
  margin-bottom: 16px;
}
.demo-color-block .demonstration {
  margin-right: 16px;
}
</style>

选择透明度

ColorPicker 支持普通颜色，也支持带 Alpha 通道的颜色，要启用 Alpha 选择，只需添加 show-alpha 属性。

<template>
  <el-color-picker v-model="color" show-alpha />
</template>
<script lang="ts" setup>
import { ref } from 'vue'
const color = ref('rgba(19, 206, 102, 0.8)')
</script>

预定义颜色

ColorPicker 支持预定义颜色

<template>
  <el-color-picker v-model="color" show-alpha :predefine="predefineColors" />
</template>
<script lang="ts" setup>
import { ref } from 'vue'
const color = ref('rgba(255, 69, 0, 0.68)')
const predefineColors = ref([
  '#ff4500',
  '#ff8c00',
  '#ffd700',
  '#90ee90',
  '#00ced1',
  '#1e90ff',
  '#c71585',
  'rgba(255, 69, 0, 0.68)',
  'rgb(255, 120, 0)',
  'hsv(51, 100, 98)',
  'hsva(120, 40, 94, 0.5)',
  'hsl(181, 100%, 37%)',
  'hsla(209, 100%, 56%, 0.73)',
  '#c7158577',
])
</script>

不同尺寸

<template>
  <div class="demo-color-sizes">
    <el-color-picker v-model="color" size="large" />
    <el-color-picker v-model="color" />
    <el-color-picker v-model="color" size="small" />
  </div>
</template>
<script lang="ts" setup>
import { ref } from 'vue'
const color = ref('409EFF')
</script>
<style>
.demo-color-sizes .el-color-picker:not(:last-child) {
  margin-right: 16px;
}
</style>

属性

属性	说明	类型	可选值	默认值
model-value / v-model	选中项绑定值	string	—	—
disabled	是否禁用	boolean	—	false
size	尺寸	string	large / default / small	—
show-alpha	是否支持透明度选择	boolean	—	false
color-format	写入 v-model 的颜色的格式	string	hsl / hsv / hex / rgb	hex (当 show-alpha 为 false) / rgb (当 show-alpha 为 true)
popper-class	ColorPicker 下拉框的类名	string	—	—
predefine	预定义颜色	array	—	—
validate-event	输入时是否触发表单的校验	boolean	-	true