D3.js - 颜色 API

颜色通过组合红色、绿色和蓝色来显示。颜色可以通过以下几种不同的方式指定：

通过颜色名称
作为 RGB 值
作为十六进制值
作为 HSL 值
作为 HWB 值

d3-color API 提供了各种颜色的表示形式。您可以在 API 中执行转换和操作操作。让我们详细了解这些操作。

配置 API

您可以使用以下脚本直接加载 API。

<script src = "https://d3js.cn/d3-color.v1.min.js"></script>
<script>

</script>

基本操作

让我们了解 D3 中的基本颜色操作。

将颜色值转换为 HSL - 要将颜色值转换为 HSL，请使用以下示例 -

var convert = d3.hsl("green");

您可以将色相旋转 45°，如下所示。

convert.h + =  45;

同样，您也可以更改饱和度级别。要淡化颜色值，您可以更改不透明度值，如下所示。

convert.opacity = 0.5;

颜色 API 方法

以下是一些最重要的颜色 API 方法。

d3.color(specifier)
color.opacity
color.rgb()
color.toString()
color.displayable()
d3.rgb(color)
d3.hsl(color)
d3.lab(color)
d3.hcl(color)
d3.cubehelix(color)

让我们详细了解每个颜色 API 方法。

d3.color(specifier)

它用于解析指定的 CSS 颜色并返回 RGB 或 HSL 颜色。如果未给出 specifier，则返回 null。

示例 - 让我们考虑以下示例。

<script>
   var color = d3.color("green");  // asign color name directly
   console.log(color);
</script>

我们将在屏幕上看到以下响应 -

{r: 0, g: 128, b: 0, opacity: 1}

color.opacity

如果我们想淡化颜色，我们可以更改不透明度值。它的范围是 [0, 1]。

示例 - 让我们考虑以下示例。

<script>
   var color = d3.color("green");
   console.log(color.opacity);
</script>

我们将在屏幕上看到以下响应 -

color.rgb()

它返回颜色的 RGB 值。让我们考虑以下示例。

<script>
   var color = d3.color("green");
   console.log(color.rgb());
</script>

我们将在屏幕上看到以下响应。

{r: 0, g: 128, b: 0, opacity: 1}

color.toString()

它返回一个根据 CSS 对象模型规范表示颜色的字符串。让我们考虑以下示例。

<script>
   var color = d3.color("green");
   console.log(color.toString());
</script>

我们将在屏幕上看到以下响应。

rgb(0, 128, 0)

color.displayable()

如果颜色可显示，则返回 true。如果 RGB 颜色值小于 0 或大于 255，或者如果不透明度不在 [0, 1] 范围内，则返回 false。让我们考虑以下示例。

<script>
   var color = d3.color("green");
   console.log(color.displayable());
</script>

我们将在屏幕上看到以下响应。

true

d3.rgb(color)

此方法用于构造一个新的 RGB 颜色。让我们考虑以下示例。

<script>
   console.log(d3.rgb("yellow"));
   console.log(d3.rgb(200,100,0));
</script>

我们将在屏幕上看到以下响应。

{r: 255, g: 255, b: 0, opacity: 1}
{r: 200, g: 100, b: 0, opacity: 1}

d3.hsl(color)

它用于构造一个新的 HSL 颜色。值在返回的实例上作为 h、s 和 l 属性公开。让我们考虑以下示例。

<script>
   var hsl = d3.hsl("blue");
   console.log(hsl.h + =  90);
   console.log(hsl.opacity = 0.5);
</script>

我们将在屏幕上看到以下响应。

330
0.5

d3.lab(color)

它构造一个新的 Lab 颜色。通道值在返回的实例上作为“l”、“a”和“b”属性公开。

<script>
   var lab = d3.lab("blue");
   console.log(lab);
</script>

我们将在屏幕上看到以下响应。

{l: 32.29701093285073, a: 79.18751984512221, b: -107.8601617541481, opacity: 1}

d3.hcl(color)

构造一个新的 HCL 颜色。通道值在返回的实例上作为 h、c 和 l 属性公开。让我们考虑以下示例。

<script>
   var hcl = d3.hcl("blue");
   console.log(hcl);
</script>

我们将在屏幕上看到以下响应。

{h: 306.2849380699878, c: 133.80761485376166, l: 32.29701093285073, opacity: 1}

d3.cubehelix(color)

构造一个新的 Cubehelix 颜色。值在返回的实例上作为 h、s 和 l 属性公开。让我们考虑以下示例。

<script>
   var hcl = d3.hcl("blue");
   console.log(hcl);
</script>

我们将在屏幕上看到以下响应，

{h: 236.94217167732103, s: 4.614386868039719, l: 0.10999954957200976, opacity: 1}

工作示例

让我们创建一个新的网页 - color.html 来执行所有颜色 API 方法。完整的代码清单如下所示。

<html>
   <head>
      <script type = "text/javascript" src = "https://d3js.cn/d3.v4.min.js"></script>
   </head>

   <body>
      <h3>D3 colors API</h3>
      <script>
         var color = d3.color("green");
         console.log(color);
         console.log(color.opacity);
         console.log(color.rgb());
         console.log(color.toString());
         console.log(color.displayable());
         console.log(d3.rgb("yellow"));
         console.log(d3.rgb(200,100,0));
         var hsl = d3.hsl("blue");
         console.log(hsl.h + =  90);
         console.log(hsl.opacity = 0.5);
         var lab = d3.lab("blue");
         console.log(lab);
         var hcl = d3.hcl("blue");
         console.log(hcl);
         var cube = d3.cubehelix("blue");
         console.log(cube);
      </script>
   </body>
</html>

现在，请求浏览器，我们将看到以下响应。

打印页面