@ap.cx/hues

中文文档
2.4.0发布于 2020/12/15MITESM + CJS零依赖近 30 天下载 2661

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

中文使用文档
文档目录25 节
  1. 如何安装
  2. 如何使用
  3. [HYOOZ]定义
  4. 职能
  5. 马上就
  6. rgb2hex 键
  7. rgba2hex 键
  8. rgb2hsl 时
  9. rgba2hsla( 纳克)
  10. 相对光度
  11. WCAG 相对亮度的定义
  12. 对比 (A11 对比度)
  13. aa 数据为:
  14. aa 数据为:
  15. 斯特尔克巴
  16. hsla 维克多3
  17. 颜色字符串
  18. 什么是相对的光芒
  19. WCAG是什么来着
  20. 获取代码
  21. 网页
  22. SSH 服务器
  23. gh (github 官方语录)
  24. npm 发布 -- -- 公开访问
  25. 许可证

[呼

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

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

如何安装


npm install --save @ap.cx/hues

or 

yarn add @ap.cx/hues

如何使用


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

或一个人...


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

或者说


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

[HYOOZ]定义

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

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

  • 大海今天有着神奇的绿地

  • 彩虹的花朵

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

职能

马上就

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

rgb2hex 键


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

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

console.log(result);

> #ffffff

rgba2hex 键


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 时


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( 纳克)


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} 对象 .

相对光度


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/ 页面存档备份,存于互联网档案馆

WCAG 相对亮度的定义

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

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

对比 (A11 对比度)

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

文本大小AA级AA级
小文本 < 184.5+ (简体中文)7个+
大文本 qq 183个+4.5+ (简体中文)

所需最低对比比值


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 数据为:


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

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

console.log(isAA);

> true // or false

aa 数据为:


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

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

console.log(isAAA);

> true // or false

斯特尔克巴


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

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


const result = str2rgba('#ffffffff')

console.log(result);

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

hsla 维克多3


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

更改 hsl 值.


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 页面存档备份,存于互联网档案馆。 。 。 .


什么是相对的光芒

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


WCAG是什么来着

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

获取代码

网页


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

SSH 服务器


git clone [email protected]:thierryc/hues.git

gh (github 官方语录)


gh repo clone thierryc/hues

npm 发布 -- -- 公开访问

📦  @ap.cx/[email protected]
=== 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  

许可证

麻省理工学院。 。 。 .

版本与发布记录

@ap.cx/hues 共发布 16 个版本,首次发布于 2020/10/10;过去 12 个月发布了 0 个版本。

版本发布日期距今
2.4.0latest2020/12/155 年前
2.3.02020/12/155 年前
2.2.02020/10/316 年前
2.1.02020/10/136 年前
2.0.62020/10/136 年前
2.0.52020/10/106 年前

关于 @ap.cx/hues 的常见问题

@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 和提交记录判断。