Skip to content

ColorPicker 颜色选择 ​

通过色板、预设色或颜色输入选择颜色,确认后更新绑定值

交互示例 ​

使用要点 ​

v-model 绑定颜色字符串,presets 配置快捷色板,aria-label 提供可访问名称

allow-alpha 默认为 true,不需要透明度时设为 false,disabled 禁用交互

查看用法代码
vue
<script setup lang="ts">
import { ZColorPicker } from '@codex-proxy/ui'
import { ref } from 'vue'

const color = ref('#5983F4')
const presets = ['#5983F4', '#0E7C72', '#A0583D']
</script>

<template>
  <ZColorPicker v-model="color" aria-label="主题色" :presets="presets" :allow-alpha="false" />
</template>

API ​

属性 ​

属性类型默认值说明
v-modelstring必填HEX 颜色值,允许透明度时可含 Alpha 通道
aria-labelstring'选择颜色'触发按钮名称
presetsreadonly string[][]预设颜色
allow-alphabooleantrue启用透明度编辑
disabledbooleanfalse禁用选择器

事件 ​

事件说明
update:modelValuestring,绑定值变化