@cyhnkckali/vue3-color-picker

中文文档
2.1.7发布于 2026/02/23TypeScriptESM + CJS零依赖近 30 天下载 4.8万

取色器组件库

中文使用文档
文档目录6 节
  1. 安装
  2. 使用/实例
  3. 选项
  4. 输出
  5. CSS 颜色变量
  6. 路线图

Vue 3 颜色拾取器

Vue 3 的色彩选择组件 。 快速且有小包大小. 渐入一体! 无依无靠! 完全定制!

带有2.0版本的特性

  • 立即改变模式的能力
  • 更改颜色列表中的值
  • 删除颜色列表中的值
  • 新样式变量
  • 新设计

不要忘记明星的动机:

试试吧 现场直播

下载1.1.9继续旧版本!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

gradient solid

安装

国家防范机制安装

 npm i @cyhnkckali/vue3-color-picker

Yarn 安装

  yarn add @cyhnkckali/vue3-color-picker

导入

导入要使用的地方
import {Vue3ColorPicker} from '@cyhnkckali/vue3-color-picker';

将样式文件导入您的主机 。 js 文件

import '@cyhnkckali/vue3-color-picker/dist/style.css'

使用/实例

<script setup>
import {Vue3ColorPicker} from '@cyhnkckali/vue3-color-picker';
</script>

<template>   

    <Vue3ColorPicker v-model="value" mode="solid" :showColorList="false" :showEyeDrop="false" type="RGBA"/>

    <Vue3ColorPicker v-model="value" mode="gradient" :showColorList="false" :showEyeDrop="false"/>

</template>

选项

参数类型说明
v-modelstring默认 ''
modestringsolid 或者说 gradient 默认 gradient
themestringlight 或者说 dark 默认 light
typestring返回颜色值类型 HEX8 RGBA RGB HEX 默认 HEX8
inputTypestring颜色值输入类型 RGB HSL HSV CMYK 默认 RGB
disabledboolean默认 false
localobject默认 { angle: '', positionX: '', positionY: '', solid: '', gradient: '', linear: '', radial: '', colorPalette: '', btnSaveLabel:'Save', btnCancelLabel:'Cancel' }
colorListCountnumber确定颜色列表默认值中要保留多少颜色 18
showColorListboolean默认 true
showEyeDropboolean默认 true 只支持 Chrome 和边缘
showAlphaboolean默认 true
showInputMenuboolean默认 true
showInputSetboolean默认 true
showPickerModeboolean默认 true
iconClassesobject默认 { ruler: '', eyeDroper: '', arrowDown: '', save: '', delete: '' }
gradientModelinear 或者说 radial默认 linear 设定拾取器启动时的初始梯度模式
showButtonsboolean默认 true

输出

参数类型说明
update:model-valueevent返回时 'color value'
onSaveevent返回时 'color value'
onCancelevent返回时 'color value'

CSS 颜色变量

变量名称十六进制暗黑十六进制
--cp-小学#5983fc #5983fc (英语)#5983fc #5983fc (英语)
-- cp 集装箱 -- bg#FFF {\FN方正黑体简体\FS18\B1\BORD1\SHAD1\3CH2F2F2F}FFFFF:#212529 212529号
--cp - 选择颜色#2c5ae6af #2c5ae6af (英语)#2c5ae6af #2c5ae6af (英语)
-- cp- 远程边界#f7f7f7 #f7f7f7 # #f7f7 # #f7f7 # #f7f7 # #f7f7 # #f7f7 # #f7f7 #f7f7 #f7f7 #f7f7 #f7f7 #f7ff7 #f7f7 #f7fff7 #f7fff7 #f7fffff7 #f7fff7ffff7 #f7f7fffffffffffffffffffffffffffffffffffffffffffffffffff#f7f7f7 #f7f7f7 # #f7f7 # #f7f7 # #f7f7 # #f7f7 # #f7f7 # #f7f7 #f7f7 #f7f7 #f7f7 #f7f7 #f7ff7 #f7f7 #f7fff7 #f7fff7 #f7fffff7 #f7fff7ffff7 #f7f7fffffffffffffffffffffffffffffffffffffffffffffffffff
-- cp- rang- 阴影#4c86f3 # 4c86f3 # (中文(简体) )#4c86f3 # 4c86f3 # (中文(简体) )
--cp-容器-阴影#58585881 #5858581 (英语)#2b262696 #2b262696 (英语)
--cp-gray-100 (英语)#f9f9f9 #f9f9f9 (英语)#1b1c22 #1b1c22 (英语)
--cp-gray-200 (英语)#f1f1f4 #f1f1f4 (中文(简体) )#26272f #26272f (英语)
--cp-gray-300 (英语)#dbdfe9 #dbdfe9 (英语)#363843 363843号
--cp-gray-400 (英语)#c4cada #c4卡达#464852 464852号
--cp-gray-500 (英语)#99a1b7 #99a1b7 (中文(简体) )#636674 #636674 (英语)
--cp-gray-600 (英语)#78829d #78829d (英语)#808290 #808290 (英语)
--cp-gray-700 (英语)#4b5675 #4b5675 (英语)#9a9cae {\fn华文楷体\fs16\1che0e0e0}9a9卡
--cp-gray-800 (英语)#252f4a #252f4a (中文(简体) )#b5b7c8 #b5b7c8 (英语)
--cp-gray-900 (英语)#071437 #071437 (英语)#f5f5f5 #f5f5f5 (中文(简体) )
-- cp- 反向黑暗#57575723 #57575723 (英语)#6b6b6b56 #6b6b6b56 (英语)
--cp-反向-白色#9292920d #9292920d (英语)#92929256 92929256号

路线图

  • 要添加的部件类型

版本与发布记录

@cyhnkckali/vue3-color-picker 共发布 47 个版本,首次发布于 2023/11/29;过去 12 个月发布了 2 个版本。

版本发布日期距今
2.1.7latest2026/02/238 个月前
2.1.62026/02/238 个月前
2.1.52025/09/021.2 年前
2.1.42025/09/021.2 年前
2.1.32025/08/291.2 年前
2.1.22025/03/251.6 年前

关于 @cyhnkckali/vue3-color-picker 的常见问题

@cyhnkckali/vue3-color-picker 是什么?

取色器组件库

如何安装 @cyhnkckali/vue3-color-picker?

在项目目录运行 npm install @cyhnkckali/vue3-color-picker,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:vue(^3.3.8)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@cyhnkckali/vue3-color-picker 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@cyhnkckali/vue3-color-picker 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@cyhnkckali/vue3-color-picker 可以商用吗?

@cyhnkckali/vue3-color-picker 使用 未声明 许可。package.json 没有声明许可证。没有许可证的代码默认保留全部权利,商用前请联系作者或查看仓库中的 LICENSE 文件。以上为概括,不构成法律意见,请以许可原文为准。

@cyhnkckali/vue3-color-picker 的下载量有多少?

根据 npm 官方下载统计,@cyhnkckali/vue3-color-picker 在 2026/10/11 – 2026/11/09 这 30 天内被下载 48,286 次,日均约 1,610 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@cyhnkckali/vue3-color-picker 还在维护吗?

最新版本 2.1.7 发布于 2026/02/23(8 个月前);至今共发布 47 个版本,其中过去 12 个月发布了 2 个;首次发布于 2023/11/29。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。