Skip to content

@neosjs/colorpicker ​

颜色选择器面板。提供饱和度/色相/透明度调节、颜色值输入、取色吸管、透明色选择、主题色/渐变色/标准色预设以及"最近使用"记录(持久化到 localStorage)。

安装 ​

sh
pnpm add @neosjs/colorpicker
sh
npm i @neosjs/colorpicker
sh
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 调节。
  • 颜色输入框:可直接输入颜色值。
  • 取色吸管:点击输入框旁的吸管按钮。浏览器支持 EyeDropper API 时调用原生吸管,否则对页面中 .canvas 元素截图生成 Canvas 取色。
  • 透明色:点击透明按钮可将颜色设置为 #00000000(全透明)。
  • 预设颜色:内置主题色、10 组渐变色与标准色,点击即选中。
  • 最近使用:自定义调节的颜色会自动记录(最多 10 个),保存在 localStorage 的 RECENT_COLORS 键下。

Props ​

参数类型默认值说明
model-value / v-modelstring'#e86b99'当前颜色值,支持任意合法 CSS 颜色字符串

Emits ​

事件名参数说明
update:modelValue(payload: string)颜色变化时触发,格式为 rgba(r,g,b,a) 字符串