# @eastdesire/jscolor 中文文档

规范地址：https://npmcn.com/package/%40eastdesire/jscolor/

版本：2\.5\.2
npm 元数据更新时间：2023-12-02T00:33:28.022Z
中文译文更新时间：2026-11-13T03:42:33.934Z
软件包许可：GPL-3\.0-or-later

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40eastdesire/jscolor
原文对照：https://npmcn.com/package/%40eastdesire/jscolor/?lang=original
项目主页：https://jscolor.com/
源码仓库：https://github.com/EastDesire/jscolor

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：174 kB，5 个文件
- 模块格式：CommonJS
- TypeScript 类型：未声明
- 运行依赖：0 个
- 首次发布：2020-06-29T05:06:06.578Z
- 最新版本发布：2023-12-02T00:33:27.845Z
- 近 30 天下载量：171558（2026-10-13 至 2026-11-11，npm 官方下载统计）
- 已发布版本数：21（近 12 个月 0 个）

## 中文简介

有不透明通道(α通道)和自定义调色板的网络取色器. 支持克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克.

## 安装

```sh
npm install @eastdesire/jscolor
```

也可以使用：`pnpm add @eastdesire/jscolor`、`yarn add @eastdesire/jscolor`、`bun add @eastdesire/jscolor`

## README

# jscolor - 带有不透明( alpha) 的 JavaScript 取色器

**jscolor.js (英语)** 是一个网络取色器 [不透明( alpha 通道) 和自定义调色板](https://jscolor.com/examples/)。 。 。 .

-   JS的单一档案 **无依赖关系**
-   支持 CSS 等颜色 **尔巴( )** 财务报告和审定财务报表 **六进制**,包括: **\# rggbbaa (英语)** 标注.
-   [下载](https://jscolor.com/release/latest.zip) 包含已修改 **jscolor.min.js (英语)**
-   移动友好

## 在两行安装

```html
<script src="jscolor.js"></script>

Color: <input value="#3399FF80" data-jscolor="{}">
```

[运行示例 >](https://jscolor.com/#installation)

## 自定义调色板( S)

```html
<script>
// These options apply to all color pickers on the page
jscolor.presets.default = {
    width: 201,
    height: 81,
    position: 'right',
    previewPosition: 'right',
    backgroundColor: '#f3f3f3',
    borderColor: '#bbbbbb',
    controlBorderColor: '#bbbbbb',
    palette: [
        '#000000', '#7d7d7d', '#870014', '#ec1c23', '#ff7e26',
        '#fef100', '#22b14b', '#00a1e7', '#3f47cc', '#a349a4',
        '#ffffff', '#c3c3c3', '#b87957', '#feaec9', '#ffc80d',
        '#eee3af', '#b5e61d', '#99d9ea', '#7092be', '#c8bfe7',
    ],
    paletteCols: 10,
    hideOnPaletteClick: true,
}
</script>
```

## 截图

[![Screenshots of jscolor](https://jscolor.com/hosted/gui/jscolor-2.4.5.png)](https://jscolor.com/examples/)

## 链接

-   [在线配置工具](https://jscolor.com/configure/)
-   [沙盒](https://jscolor.com/sandbox/)
-   [实例](https://jscolor.com/examples/)
-   [下载](https://jscolor.com/download/) 包括已修改 **jscolor.min.js (英语)**

## 特征

-   **不需要框架**  
    jscolor.js是一个完全自给自足的JavaScript库,仅由梵地拉JavaScript的一个文件组成. 它不需要任何框架(jQuery,Dojo,MooTools等). 但它当然可以与它们共存.
    
-   **交叉浏览器**  
    所有现代浏览器都得到支持,包括: Edge, Firefox, Chrome, Safari, Opera, Internet Explorer 10及以上, 等. .
    
-   **高度定制**  
    jscolor 提供了许多 [配置选项](https://jscolor.com/docs/#doc-api-options)。无论您需要改变取色器的大小或颜色,还是将一个函数附加到它的变换事件上,配置都可以为您的网络项目进行微调.
    
-   **移动友好**  
    在对触摸事件的内置支持下,jscolor被设计成易于被平板电脑和智能手机等触摸设备所使用.
    

## 许可证

-   [GNU GPL v3 (英语)](http://www.gnu.org/licenses/gpl-3.0.txt) 用于开源
-   [商业执照](https://jscolor.com/download/#licenses) 用于商业用途

## 网站

关于jscolor项目的更多信息,见 [jscolor 网站](https://jscolor.com/)

## 常见问题

### @eastdesire/jscolor 是什么？

有不透明通道\(α通道\)和自定义调色板的网络取色器\. 支持克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克\.

### 如何安装 @eastdesire/jscolor？

在项目目录运行 npm install @eastdesire/jscolor，或使用 pnpm add / yarn add / bun add。

### @eastdesire/jscolor 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/eastdesire\_\_jscolor 是否存在。

### @eastdesire/jscolor 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @eastdesire/jscolor 可以商用吗？

@eastdesire/jscolor 使用 GPL-3\.0-or-later 许可。强 Copyleft：分发包含该代码的软件时，整个作品需以 GPL-3\.0 兼容许可开源，并附带专利与反锁定条款。仅内部使用不触发此义务。以上为概括，不构成法律意见，请以许可原文为准。

### @eastdesire/jscolor 的下载量有多少？

根据 npm 官方下载统计，@eastdesire/jscolor 在 2026/10/13 – 2026/11/11 这 30 天内被下载 171,558 次，日均约 5,719 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @eastdesire/jscolor 还在维护吗？

最新版本 2\.5\.2 发布于 2023/12/02（2 年前）；至今共发布 21 个版本，其中过去 12 个月发布了 0 个；首次发布于 2020/06/29。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。