【 D3.js 入门系列 — 2 】 绑定数据和选择元素

时间:2022-06-17 19:55:47

1. 如何绑定数据

D3 有一个很独特的功能:能将数据绑定到 DOM 上,也就是绑定到文档上。这么说可能不好理解,例如网页中有段落元素<p>,我们可以将整数 5 与 <p>绑定到一起。

D3 中是通过 data() 和 datum() 函数来绑定数据的,最常用的是 data()。

现有如下 HTML 代码:

<p>Hello World 1</p>
<p>Hello World 2</p>
<p>Hello World 3</p>

然后,有如下数据:

var set = ["I like dog","I like cat","I like snake"];

这是一个数组,有三项。现在要将这三项分别绑定到三个段落元素上,即:

Hello World 1 与 I like dog 绑定
Hello World 2 与 I like cat 绑定
Hello World 3 与 I like snake 绑定
调用 data() 绑定数据,并替换三个段落元素的字符串为被绑定的字符串,代码如下:

var sp = d3.select("body").selectAll("p");   //选择元素
sp.data(set)             //绑定数据
  .text(function(d,i){
      return d;
  });

这段代码中,

第 1 行:选择 <body> 里的所有 <p> 元素,并将选择集赋值给一个变量 sp。

第 2 行:使用函数 data() 绑定数组 set。

第 3 – 5 行:更改段落元素的内容。后面有一个无名函数 funciont(d,i),这里的两个参数:第一个参数的意思是 datum(数据),第二个参数的意思是 index(索引)。

在 function(d, i) 里,情况如下:

当 i == 0 时, d 为 I like dog。
当 i == 1 时, d 为 I like cat。
当 i == 2 时, d 为 I like snake。
此时,三个段落元素与数组 set 的三个字符串是一一对应的,因此,在函数 function(d, i) 里添加一句代码 return d; 即可。

结果如下图:

【 D3.js 入门系列 — 2 】 绑定数据和选择元素

如果不绑定数组 set ,想要将所有段落都变为相同的字符串(如都变成 China),只需:

sp.text("China");

即可。

2. 如何选择元素

在【入门 – 第 1 章】和上文中,已经尝试过选择 HTML 元素了。在 D3 中,主要是用 select() 和 selectAll() 两个函数。

使用方式为:d3.select(“p”) 和 d3.selectAll(“p”)

select() 默认选择文档中所指定的第一个元素,selectAll 是选择所指定的所有的元素。

这里就有一个问题:如何选择非第一个元素呢?假设我们只想选择第三个 <p> 元素 Hello World 3 ,怎么办呢?

有两个办法:

(1)为第三个 <p> 赋予一个 id,即

<p id="p3">Hello World 3</p>

再选择

var sp = d3.select("#p3");   //选择元素

再进行操作即可。

(2)如果绑定了数据,则可在 function(d,i) 里操作,例如

sp.text(function(d,i){
        if(i==2){
     ....
    }  
       //如果不指定 i == 0 和 i == 1 的操作的话,会自动返回空值
});

但是要注意,用这种方法,必须要指定当 i 不等于 2 时的操作,否则会返回空值,即第 1 个段落和第 2 个段落变为空。