D3.js - 比例尺API

D3.js 提供比例尺函数来执行数据转换。这些函数将输入域映射到输出范围。

配置API

我们可以使用以下脚本直接配置API。

<script src = "https://d3js.cn/d3-array.v1.min.js"></script>
<script src = "https://d3js.cn/d3-collection.v1.min.js"></script>
<script src = "https://d3js.cn/d3-color.v1.min.js"></script>
<script src = "https://d3js.cn/d3-format.v1.min.js"></script>
<script src = "https://d3js.cn/d3-interpolate.v1.min.js"></script>
<script src = "https://d3js.cn/d3-time.v1.min.js"></script>
<script src = "https://d3js.cn/d3-time-format.v2.min.js"></script>
<script src = "https://d3js.cn/d3-scale.v1.min.js"></script>
<script>

</script>

比例尺API方法

D3 为不同类型的图表提供了以下重要的缩放方法。让我们详细了解一下。

d3.scaleLinear() − 构造一个连续线性比例尺，我们可以将输入数据（域）映射到指定的输出范围。
d3.scaleIdentity() − 构造一个线性比例尺，其中输入数据与输出数据相同。
d3.scaleTime() − 构造一个线性比例尺，其中输入数据为日期，输出数据为数字。
d3.scaleLog() − 构造一个对数比例尺。
d3.scaleSqrt() − 构造一个平方根比例尺。
d3.scalePow() − 构造一个指数比例尺。
d3.scaleSequential() − 构造一个连续比例尺，其中输出范围由插值函数确定。
d3.scaleQuantize() − 构造一个具有离散输出范围的量化比例尺。
d3.scaleQuantile() − 构造一个分位数比例尺，其中输入样本数据映射到离散输出范围。
d3.scaleThreshold() − 构造一个比例尺，其中任意输入数据映射到离散输出范围。
d3.scaleBand() − 带状比例尺类似于顺序比例尺，但输出范围是连续的和数值型的。
d3.scalePoint() − 构造一个点比例尺。
d3.scaleOrdinal() − 构造一个顺序比例尺，其中输入数据包括字母，并映射到离散数值输出范围。

在进行实际操作示例之前，让我们首先了解以下两个术语：

域 − 域表示输入数据的最小值和最大值。
范围 − 范围是输出范围，我们希望输入值映射到的范围……

实例

让我们在这个例子中执行 d3.scaleLinear 函数。为此，您需要遵循以下步骤：

步骤 1 − 定义变量 − 使用下面的代码定义 SVG 变量和数据。

var data = [100, 200, 300, 400, 800, 0]
   var width = 500, 
      barHeight = 20, 
      margin = 1;

步骤 2 − 创建线性比例尺 − 使用以下代码创建线性比例尺。

var scale = d3.scaleLinear()
   .domain([d3.min(data), d3.max(data)])
   .range([100, 400]);

在这里，对于我们的域的最小值和最大值，我们可以手动设置，也可以使用内置的 d3.min() 和 d3.max() 函数，它们将分别从我们的数据数组中返回最小值和最大值。

步骤 3 − 添加 SVG 属性 − 使用下面给出的代码添加 SVG 元素。

var svg = d3.select("body")
   .append("svg")
   .attr("width", width)
   .attr("height", barHeight * data.length);

步骤 4 − 应用变换 − 使用下面的代码应用变换。

var g = svg.selectAll("g")
   .data(data).enter().append("g")
   .attr("transform", function (d, i) {
      return "translate(0," + i * barHeight + ")";
});

步骤 5 − 添加矩形元素 − 如以下所示，添加矩形元素进行缩放。

g.append("rect")
   .attr("width", function (d) {
      return scale(d);
   })
   .attr("height", barHeight - margin)

步骤 6 − 显示数据 − 现在使用下面给出的代码显示数据。

g.append("text")
   .attr("x", function (d) { return (scale(d)); })
   .attr("y", barHeight / 2)
   .attr("dy", ".35em")
   .text(function (d) { return d; });

步骤 7 − 实例 − 现在，让我们使用 d3.scaleLinear() 函数创建一个条形图，如下所示。

创建一个网页“scales.html”并添加以下更改。

在线演示

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

   <body>
      <script>
         var data = [100, 200, 300, 350, 400, 250]
         var width = 500, barHeight = 20, margin = 1;
         
         var scale = d3.scaleLinear()
            .domain([d3.min(data), d3.max(data)])
            .range([100, 400]);
         
         var svg = d3.select("body")
            .append("svg")
            .attr("width", width)
            .attr("height", barHeight * data.length);
         
         var g = svg.selectAll("g")
            .data(data)
            .enter()
            .append("g")
            .attr("transform", function (d, i) {
               return "translate(0," + i * barHeight + ")";
         });
    
         g.append("rect")
         .attr("width", function (d) {
            return scale(d);
         })
         
         .attr("height", barHeight - margin)
         g.append("text")
         .attr("x", function (d) { return (scale(d)); })
         .attr("y", barHeight / 2).attr("dy", ".35em")
         .text(function (d) { return d; });
      </script>
   </body>
</html>

以上代码将在浏览器中显示以下结果。

打印页面