@neosjs/colorpicker
颜色选择器面板。提供饱和度/色相/透明度调节、颜色值输入、取色吸管、透明色选择、主题色/渐变色/标准色预设以及"最近使用"记录(持久化到 localStorage)。
安装
sh
pnpm add @neosjs/colorpickersh
npm i @neosjs/colorpickersh
yarn add @neosjs/colorpicker快速上手
通过 v-model 绑定颜色字符串,支持 HEX / RGB 等格式(内部基于 tinycolor2 解析)。
vue
<script setup lang="ts">
import { ColorPicker } from '@neosjs/colorpicker'
import { ref } from 'vue'
const color = ref('#e86b99')
</script>
<template>
<ColorPicker v-model="color" />
</template>功能说明
- 饱和度 / 色相 / 透明度:面板顶部的色板配合下方两条滑杆完成 HSB + Alpha 调节。
- 颜色输入框:可直接输入颜色值。
- 取色吸管:点击输入框旁的吸管按钮。浏览器支持
EyeDropperAPI 时调用原生吸管,否则对页面中.canvas元素截图生成 Canvas 取色。 - 透明色:点击透明按钮可将颜色设置为
#00000000(全透明)。 - 预设颜色:内置主题色、10 组渐变色与标准色,点击即选中。
- 最近使用:自定义调节的颜色会自动记录(最多 10 个),保存在 localStorage 的
RECENT_COLORS键下。
Props
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| model-value / v-model | string | '#e86b99' | 当前颜色值,支持任意合法 CSS 颜色字符串 |
Emits
| 事件名 | 参数 | 说明 |
|---|---|---|
| update:modelValue | (payload: string) | 颜色变化时触发,格式为 rgba(r,g,b,a) 字符串 |