ColorPicker 颜色选择器
用于主题色彩自定义、画板调色与 HEX 十六进制颜色拾取的调色盘控件,支持彩虹 Hue 光谱滑动、明度微调、预设调色板与 HEX 直接输入。
代码示例
1. 内嵌调色面板 (Inline Mode)
设置 mode="inline" 直接在页面内渲染完整调色盘。
vue
<template>
<mu-color-picker v-model:value="color" mode="inline" />
</template>
<script setup>
import { ref } from 'vue'
const color = ref('#3B82F6')
</script>2. 弹出展开模式 (Popup Mode)
设置 mode="popup" 渲染微型色彩小胶囊触发器,点击后再折叠展开完整面板。
vue
<template>
<mu-color-picker v-model:value="color" mode="popup" />
</template>API 属性说明 (Props)
| 参数名 | 说明 | 类型 | 可选值 | 默认值 |
|---|---|---|---|---|
| v-model:value | 选中的 HEX 颜色字符串 | String | - | '#171717' |
| mode | 选择器面板模式 | String | inline | popup | 'inline' |
| presetColors | 预设快捷选色盘 HEX 字符串数组 | Array | - | 常用 HEX 颜色列表 |
事件说明 (Events)
| 事件名 | 说明 | 回调参数 |
|---|---|---|
| change | 颜色拾取改变时触发 | (colorHex: String) |
| confirm | 点击确定按钮时触发 (popup 模式) | (colorHex: String) |
| update:value | 双向绑定更改变 | (colorHex: String) |