element-plus/website/docs/jp/color-picker.md
2020-11-04 10:30:14 +08:00

3.3 KiB

Color-picker

color-pickerは、複数のカラーフォーマットに対応したカラーセレクターです。

基本的な使い方

:::demo color-pickerは、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>

:::

アルファ

:::demo color-pickerはアルファチャンネルの選択をサポートしています。アルファチャンネルの選択を有効にするには、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>

:::

定義済みの色

:::demo color-pickerは事前定義されたカラーオプションをサポートしています。

<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>

:::

サイズ

:::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>

:::

属性

Attribute Description Type Accepted Values Default
value / v-model バインディング値 string
disabled color-pickerを無効にするかどうか boolean false
size color-pickerのサイズ string medium / small / mini
show-alpha アルファスライダーを表示するかどうか boolean false
color-format v-modelの色形式 string hsl / hsv / hex / rgb hex (when show-alpha is false)/ rgb (when show-alpha is true)
popper-class color-pickerのドロップダウンのカスタムクラス名 string
predefine 定義済みカラーオプション array

イベント

Event Name Description Parameters
change 入力値変更時のトリガ color value
active-change 現在アクティブな色が変更されたときにトリガされます。 active color value