D3.js - 颜色 API
颜色由红色、绿色和蓝色组合显示。颜色可以通过以下不同方式指定 −
- 通过颜色名称
- 作为 RGB 值
- 作为十六进制值
- 作为 HSL 值
- 作为 HWB 值
d3-color API 提供各种颜色的表示。您可以在 API 中执行转换和操作。让我们详细了解这些操作。
配置 API
您可以使用以下脚本直接加载 API。
<script src = "https://d3js.org/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)
让我们详细了解这些 Color API 方法。
d3.color(specifier)
它用于解析指定的 CSS 颜色并返回 RGB 或 HSL 颜色。如果没有给出 specifier,则返回 null。
示例 − 让我们考虑以下示例。
<script> var color = d3.color("green"); // 直接分配颜色名称 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>
我们将在屏幕上看到以下响应 −
1
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.org/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>
现在,请求浏览器,我们将看到以下响应。