element-plus/website/docs/es/color-picker.md
PengMingJiu 886f2a3075
docs(docs): update the 'value' property to 'ModelValue' (#2044)
* docs(docs): update the 'value' property to 'ModelValue'

* docs: replace modelValue to model-value
2021-05-24 11:10:53 +08:00

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