D3.js - 比例尺API

D3.js 提供比例尺函式來執行資料轉換。這些函式將輸入域對映到輸出範圍。

配置API

我們可以使用以下指令碼直接配置API。

<script src = "https://d3js.org/d3-array.v1.min.js"></script>
<script src = "https://d3js.org/d3-collection.v1.min.js"></script>
<script src = "https://d3js.org/d3-color.v1.min.js"></script>
<script src = "https://d3js.org/d3-format.v1.min.js"></script>
<script src = "https://d3js.org/d3-interpolate.v1.min.js"></script>
<script src = "https://d3js.org/d3-time.v1.min.js"></script>
<script src = "https://d3js.org/d3-time-format.v2.min.js"></script>
<script src = "https://d3js.org/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.org/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>

以上程式碼將在瀏覽器中顯示以下結果。

列印頁面