mirror of
https://gitee.com/element-plus/element-plus.git
synced 2024-12-15 01:41:20 +08:00
886f2a3075
* docs(docs): update the 'value' property to 'ModelValue' * docs: replace modelValue to model-value
3.7 KiB
3.7 KiB
ColorPicker
ColorPicker es un selector de color que soporta varios formatos de color.
Uso básico
:::demo ColorPicker requiere una variable de tipo string
para ser enlazada a v-model
.
<div class="block">
<span class="demonstration">Especifica valor por defecto</span>
<el-color-picker v-model="color1"></el-color-picker>
</div>
<div class="block">
<span class="demonstration">No especifica valor por defecto</span>
<el-color-picker v-model="color2"></el-color-picker>
</div>
<script>
export default {
data() {
return {
color1: '#409EFF',
color2: null
}
}
};
</script>
:::
Alpha
:::demo ColorPicker soporta selección de canales alpha. Para activarlo sólo agregue el atributo show-alpha
.
<el-color-picker v-model="color" show-alpha></el-color-picker>
<script>
export default {
data() {
return {
color: 'rgba(19, 206, 102, 0.8)'
}
}
};
</script>
:::
Colores predefinidos
:::demo ColorPicker soporta opciones de color predefinidas
<el-color-picker
v-model="color"
show-alpha
:predefine="predefineColors">
</el-color-picker>
<script>
export default {
data() {
return {
color: 'rgba(255, 69, 0, 0.68)',
predefineColors: [
'#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>
:::
Sizes
:::demo
<el-color-picker v-model="color"></el-color-picker>
<el-color-picker v-model="color" size="medium"></el-color-picker>
<el-color-picker v-model="color" size="small"></el-color-picker>
<el-color-picker v-model="color" size="mini"></el-color-picker>
<script>
export default {
data() {
return {
color: '#409EFF'
}
}
};
</script>
:::
Atributos
Atributo | Descripción | Tipo | Valores aceptados | Por defecto |
---|---|---|---|---|
model-value / v-model | valor enlazado | string | — | — |
disabled | especifica si se deshabilita el ColorPicker | boolean | — | false |
size | tamaño del ColorPicker | string | — | medium / small / mini |
show-alpha | especifica si se muestra el control deslizante para el valor alpha | boolean | — | false |
color-format | formato de color del v-model |
string | hsl / hsv / hex / rgb | hex (si show-alpha es false)/ rgb (si show-alpha es true) |
popper-class | nombre de clase para el dropdown del ColorPicker | string | — | — |
predefine | opciones de colores predefinidas | array | — | — |
Eventos
Nombre de Evento | Descripción | Parametros |
---|---|---|
change | se dispara cuando el valor del input cambia | valor del color |
active-change | se dispara cuando el actual color activo cambia | valor del color activo |