D3.js - 数据连接

数据连接是 D3.js 中的另一个重要概念。它与选择一起工作,使我们能够根据数据集(一系列数值)操作 HTML 文档。默认情况下,D3.js 在其方法中为数据集赋予最高优先级,数据集中的每个项目都对应一个 HTML 元素。本章详细介绍了数据连接。

什么是数据连接?

数据连接使我们能够根据现有 HTML 文档中的数据集注入、修改和删除元素(HTML 元素以及嵌入的 SVG 元素)。默认情况下,数据集中的每个数据项都对应文档中的一个元素(图形)。

随着数据集的变化,相应的元素也可以轻松操作。数据连接在我们的数据和文档的图形元素之间建立了密切的关系。数据连接使基于数据集的元素操作变得非常简单和容易。

数据连接如何工作?

数据连接的主要目的是将现有文档的元素与给定的数据集进行映射。它根据给定的数据集创建文档的虚拟表示,并提供使用虚拟表示的方法。让我们考虑一个简单的数据集,如下所示。

[10, 20, 30, 25, 15]

数据集有五个项目,因此可以将其映射到文档的五个元素。让我们使用选择器的 selectAll() 方法和数据连接的 data() 方法将其映射到以下文档的 li 元素。

HTML

<ul id = "list">
<li><li>
<li></li>
</ul>

D3.js 代码

d3.select("#list").selectAll("li").data([10, 20, 30, 25, 15]);

现在,文档中有五个虚拟元素。前两个虚拟元素是文档中定义的两个 li 元素,如下所示。

1. li - 10
2. li - 20

对于前两个 li,我们可以使用选择器的所有元素修改方法,如 attr()、style()、text() 等,如下所示。

d3.select("#list").selectAll("li")
    .data([10, 20, 30, 25, 15])
    .text(function(d) { return d; });

text() 方法中的函数用于获取 li 元素映射数据。这里,d 代表第一个 li 元素的 10 和第二个 li 元素的 20。

接下来的三个元素可以映射到任何元素,可以使用数据连接的 enter() 和选择器的 append() 方法完成。 enter() 方法允许访问剩余数据(未映射到现有元素),append() 方法用于从相应数据创建新元素。让我们为剩余数据项创建 li。数据映射如下 −

3. li - 30
4. li - 25
5. li - 15

新建一个li元素的代码如下 −

d3.select("#list").selectAll("li")
    .data([10, 20, 30, 25, 15])
    .text(function(d) { return "This is pre-existing element and the value is " + d; })
    .enter()
    .append("li")
    .text(function(d)
{ return "This is dynamic created element and the value is " + d; });

数据连接提供了另一种方法,称为 exit() 方法,用于处理从数据集中动态删除的数据项,如下所示。

d3.selectAll("li")
    .data([10, 20, 30, 15])
    .exit()
    .remove()

在这里,我们使用 exit() 和 remove() 方法从数据集及其对应的 li 中删除了第四项。

完整代码如下−

<!DOCTYPE html>
<html>
   <head>
      <script type = "text/javascript" src = "https://d3js.org/d3.v4.min.js"></script>
      <style>
         body { font-family: Arial; }
      </style>
   </head>

   <body>
      <ul id = "list">
         <li></li>
         <li></li>
      </ul>
        
      <input type = "button" name = "remove" value = "Remove fourth value" 
         onclick = "javascript:remove()" />
      
      <script>
         d3.select("#list").selectAll("li")
            .data([10, 20, 30, 25, 15])
            .text(function(d) 
               { return "This is pre-existing element and the value is " + d; })
            .enter()
            .append("li")
            .text(function(d) 
               { return "This is dynamically created element and the value is " + d; });
             
         function remove() {
            d3.selectAll("li")
            .data([10, 20, 30, 15])
            .exit()
            .remove()
         }
      </script>
   </body>
</html>

上述代码的结果如下 −