Skip to content

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选择器面板模式Stringinline | popup'inline'
presetColors预设快捷选色盘 HEX 字符串数组Array-常用 HEX 颜色列表

事件说明 (Events)

事件名说明回调参数
change颜色拾取改变时触发(colorHex: String)
confirm点击确定按钮时触发 (popup 模式)(colorHex: String)
update:value双向绑定更改变(colorHex: String)

基于 MIT 协议开源发行

H5 模拟器 (color-picker)☀️🔄