# @ap\.cx/hues 中文文档

规范地址：https://npmcn.com/package/%40ap.cx/hues/

版本：2\.4\.0
npm 元数据更新时间：2022-04-04T14:30:33.556Z
中文译文更新时间：2026-11-06T17:01:08.710Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40ap.cx/hues
原文对照：https://npmcn.com/package/%40ap.cx/hues/?lang=original
项目主页：https://github.com/thierryc/hues#readme
源码仓库：https://github.com/thierryc/hues

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

- 包体积（解压后）：38.7 kB，5 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：未声明
- 运行依赖：0 个
- 首次发布：2020-10-09T18:28:22.898Z
- 最新版本发布：2020-12-14T22:51:34.672Z
- 近 30 天下载量：2661（2026-10-06 至 2026-11-04，npm 官方下载统计）
- 已发布版本数：16（近 12 个月 0 个）

## 中文简介

胡斯\[HYOOZ\]是一个非常简单的 **零依赖性** javascript (tiny) 为无障碍、 RGBa 和 HSLa 操纵而建的已测试的色彩库.

## 安装

```sh
npm install @ap.cx/hues
```

也可以使用：`pnpm add @ap.cx/hues`、`yarn add @ap.cx/hues`、`bun add @ap.cx/hues`

## README

# \[呼

胡斯\[HYOOZ\]是一个非常简单的 **零依赖性** javascript (tiny) 为无障碍、 RGBa 和 HSLa 操纵而建的已测试的色彩库.

彩色的Hues,Tints,Shades,以及Tones,Hues只是颜色的又一词. QQ

## 如何安装

```shell

npm install --save @ap.cx/hues

or 

yarn add @ap.cx/hues

```

## 如何使用

```js

import * as hues from "@ap.cx/hues";

```

或一个人...

```js

import str2rgba from "@ap.cx/hues";

```

或者说

```js

const {
  str2rgba,
  rgba2hsla,
  rgb2hsl,
  hsla2rgba,
  hsl2rgb,
  rgba2hex,
  rgb2hex,
  contrast,
  relativeLuminance,
  aa,
  aaa,
} = require("@ap.cx/hues");

```

## \[HYOOZ\]定义

相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相.

花是颜色的属性,使它们彼此相区别,由主要的光波长度决定—— 与可见光谱最短波长相接的花色为紫色.

-   大海今天有着神奇的绿地
    
-   彩虹的花朵
    

这个小的lib是关于RGBa和HSLa的颜色和无障碍(AA,AAA).

## 职能

-   [斯特尔克巴](https://npmcn.com/package/%40ap.cx/hues/#readme-str2rgba), (中文(简体) ),
-   [rgba2hsla( 纳克)](https://npmcn.com/package/%40ap.cx/hues/#readme-rgba2hsla), (中文(简体) ),
-   [rgb2hsl 时](https://npmcn.com/package/%40ap.cx/hues/#readme-rgb2hsl), (中文(简体) ),
-   [hsla2rgba (英语)](https://npmcn.com/package/%40ap.cx/hues/#readme-hsla2rgba), (中文(简体) ),
-   [hsl2 尔克b](https://npmcn.com/package/%40ap.cx/hues/#readme-hsl2rgb), (中文(简体) ),
-   [rgba2hex 键](https://npmcn.com/package/%40ap.cx/hues/#readme-rgba2hex), (中文(简体) ),
-   [rgb2hex 键](https://npmcn.com/package/%40ap.cx/hues/#readme-rgb2hex), (中文(简体) ),
-   [对比](https://npmcn.com/package/%40ap.cx/hues/#readme-contrast), (中文(简体) ),
-   [相对光度](https://npmcn.com/package/%40ap.cx/hues/#readme-relativeLuminance), (中文(简体) ),
-   [aa 数据为:](https://npmcn.com/package/%40ap.cx/hues/#readme-aa), (中文(简体) ),
-   [页:1](https://npmcn.com/package/%40ap.cx/hues/#readme-aaa), (中文(简体) ),
-   [hsla 维克多3](https://npmcn.com/package/%40ap.cx/hues/#readme-hslaVector3)

### 马上就

-   颜色为盲( 即时)
-   最近的可访问颜色( 顺风)
-   最接近的颜色为盲人安全颜色( 很快)

## rgb2hex 键

```js

import { rgb2hex } from "@ap.cx/hues";

const result = rgb2hex({
  r: 1.0,
  g: 1.0,
  b: 1.0,
});

console.log(result);

> #ffffff

```

## rgba2hex 键

```js

import { rgba2hex } from "@ap.cx/hues";

const result = rgba2hex({
  r: 1.0,
  g: 1.0,
  b: 1.0,
  a: 1.0
});

console.log(result);

> #ffffffff

```

## rgb2hsl 时

```js

import { rgb2hsl } from "@ap.cx/hues";

const result = rgb2hsl({
  r: 1.0,
  g: 1.0,
  b: 1.0,
});

console.log(result);

> {
  h: 0,
  s: 0,
  l: 100,
}

```

将 {r, g, b} 对象转换为 {h, s, l} 对象 .

## rgba2hsla( 纳克)

```js

import { rgba2hsla } from "@ap.cx/hues";

const result = rgb2hsl({
  r: 1.0,
  g: 1.0,
  b: 1.0,
  a: 1.0
});

console.log(result);

> {
  h: 0,
  s: 0,
  l: 100,
  a: 1,
}

```

将 {r, g, b, a} 对象转换为 {h, s, l, a} 对象 .

## 相对光度

```js

import { relativeLuminance } from "@ap.cx/hues";

const result = relativeLuminance({
  r: 1.0,
  g: 1.0,
  b: 1.0,
  a: 1.0
});

console.log(result);

> 1

```

[https://www.topster.net/relative-luminance/ 页面存档备份,存于互联网档案馆](https://www.topster.net/relative-luminance/)

### WCAG 相对亮度的定义

色相空间中任意点的相对亮度,最暗的黑色和最浅的白色分别正常为0和1.

[https://www.w3.org/WAI/GL/wiki/Relative luminance (英语)](https://www.w3.org/WAI/GL/wiki/Relative_luminance)

## 对比 (A11 对比度)

比较2相对光度并计算出无障碍率.

| 文本大小 | AA级 | AA级 |
| :-- | --: | --: |
| 小文本 < 18 | 4.5+ (简体中文) | 7个+ |
| 大文本 qq 18 | 3个+ | 4.5+ (简体中文) |
|  |  |  |

所需最低对比比值

```js

import { contrast, relativeLuminance } from "@ap.cx/hues";

const relativeLuminance1 = relativeLuminance({
  r: 1.0,
  g: 1.0,
  b: 1.0,
  a: 1.0
});

const relativeLuminance2 = relativeLuminance({
  r: 0.0,
  g: 0.0,
  b: 0.0,
  a: 0.0
});

const ratio = contrast(
  relativeLuminance1,
  relativeLuminance2,
);

console.log(ratio);

> 21

```

## aa 数据为:

```js

import { aa } from "@ap.cx/hues";

const isAA = aa(ratio); // contrat ratio

console.log(isAA);

> true // or false

```

## aa 数据为:

```js

import { aa } from "@ap.cx/hues";

const isAAA = aa(ratio); // contrat ratio

console.log(isAAA);

> true // or false

```

## 斯特尔克巴

```js

import { str2rgba } from "@ap.cx/hues";

```

将 Css 颜色字符串转换为浮点的 rgba 对象.

```js

const result = str2rgba('#ffffffff')

console.log(result);

> {
r: 1.0,
g: 1.0,
b: 1.0,
a: 1.0,
}

```

## hsla 维克多3

```js

import { hslaVector3 } from "@ap.cx/hues";

```

更改 hsl 值.

```js

const result = hslaVector3({ h: 0, s: 90, l: 90, a: 1 }, [0,0,1])

console.log(result);

> { h: 0, s: 90, l: 91, a: 1 };

```

* * *

## 颜色字符串

如果您想要使用颜色字符串请查看 [https://github.com/Qix-/color-string 页面存档备份,存于互联网档案馆](https://npmcn.com/package/%40ap.cx/hues/Qix-/color-string)。 。 。 .

* * *

## 什么是相对的光芒

相对亮度遵循了光度测定的亮度定义,但参照白色的值通常为1或100。 与光度测定定义一样,它与特定方向的发光通量密度有关,发光通量密度被CIE标准观察器的发光函数y(λ)加权. 在绝对复制不切实际的系统中,使用相对值是有用的. 例如,在平面媒体的预压中,从平面上反射出光线的绝对亮度取决于发光,因此无法保证绝对复制.

* * *

## WCAG是什么来着

网络内容无障碍准则(WCAG)由W3C WAI(万维网联盟网络无障碍倡议)制定,目的是为网络内容无障碍提供单一的共享标准. WCAG文件解释了如何使视觉、听觉、身体、语言、认知、语言、学习和神经残疾的人更容易获得网络内容.

## 获取代码

### 网页

```shell

git clone https://github.com/thierryc/hues.git

```

### SSH 服务器

```shell

git clone git@github.com:thierryc/hues.git

```

### gh (github 官方语录)

```shell

gh repo clone thierryc/hues

```

## npm 发布 -- -- 公开访问

```txt
📦  @ap.cx/hues@2.0.1
=== Tarball Contents ===
9.0kB  dist/hues.cjs.js
8.8kB  dist/hues.esm.js
10.0kB dist/hues.umd.js
695B   package.json
1.9kB  README.md
=== Tarball Details ===
name:          @ap.cx/hues
version:       2.0.1
package size:  5.6 kB
unpacked size: 30.5 kB
shasum:        36d55d09a0030aba49dc0146367e29970d652908
total files:   5  
```

## 许可证

[麻省理工学院](https://npmcn.com/package/%40ap.cx/hues/LICENSE)。 。 。 .

## 常见问题

### @ap\.cx/hues 是什么？

胡斯\[HYOOZ\]是一个非常简单的 零依赖性 javascript \(tiny\) 为无障碍、 RGBa 和 HSLa 操纵而建的已测试的色彩库\.

### 如何安装 @ap\.cx/hues？

在项目目录运行 npm install @ap\.cx/hues，或使用 pnpm add / yarn add / bun add。

### @ap\.cx/hues 支持 TypeScript 吗？

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

### @ap\.cx/hues 支持 ESM 还是 CommonJS？

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

### @ap\.cx/hues 可以商用吗？

@ap\.cx/hues 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @ap\.cx/hues 的下载量有多少？

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

### @ap\.cx/hues 还在维护吗？

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