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

D3 容许将数据与被选择的元素绑定在一块儿，为根据数据来操做元素提供方便。

如何选择元素

在 D3 中，用于选择元素的函数有两个：

• d3.select()：是选择全部指定元素的第一个
• d3.selectAll()：是选择指定元素的所有

这两个函数返回的结果称为选择集，常见用法以下。

var body = d3.select("body"); //选择文档中的body元素
var p1 = body.select("p");      //选择body中的第一个p元素
var p = body.selectAll("p");    //选择body中的全部p元素
var svg = body.select("svg");   //选择body中的svg元素
var rects = svg.selectAll("rect");  //选择svg中全部的svg元素

选择集和绑定数据一般是一块儿使用的。

如何绑定数据

D3 有一个很独特的功能：能将数据绑定到 DOM 上，也就是绑定到文档上。这么说可能很差理解，例如网页中有段落元素 p 和一个整数 5，因而能够将整数 5 与 p 绑定到一块儿。绑定以后，当须要依靠这个数据才操做元素的时候，会很方便。

D3 中是经过如下两个函数来绑定数据的：

• datum()：绑定一个数据到选择集上
• data()：绑定一个数组到选择集上，数组的各项值分别与选择集的各元素绑定

相对而言，data() 比较经常使用。

假设如今有三个段落元素以下。

<p>Apple</p>
<p>Pear</p>
<p>Banana</p>

接下来分别使用 datum() 和 data()，将数据绑定到上面三个段落元素上。

datum()

假设有一字符串 China，要将此字符串分别与三个段落元素绑定，代码以下：

var str = "China";

var body = d3.select("body");
var p = body.selectAll("p");

p.datum(str);

p.text(function(d, i){
    return "第 "+ i + " 个元素绑定的数据是 " + d;
});

绑定数据后，使用此数据来修改三个段落元素的内容，其结果以下：

第 0 个元素绑定的数据是 China 
第 1 个元素绑定的数据是 China 
第 2 个元素绑定的数据是 China 

在上面的代码中，用到了一个无名函数 function(d, i)。当选择集须要使用被绑定的数据时，常须要这么使用。其包含两个参数，其中：

• d 表明数据，也就是与某元素绑定的数据
• i 表明索引，表明数据的索引号，从 0 开始

例如，上述例子中：第 0 个元素 apple 绑定的数据是 China。

data()

有一个数组，接下来要分别将数组的各元素绑定到三个段落元素上。

var dataset = ["I like dogs","I like cats","I like snakes"];

绑定以后，其对应关系的要求为：

• Apple 与 I like dogs 绑定
• Pear 与 I like cats 绑定
• Banana 与 I like snakes 绑定

调用 data() 绑定数据，并替换三个段落元素的字符串为被绑定的字符串，代码以下：

var body = d3.select("body");
var p = body.selectAll("p");

p.data(dataset)
  .text(function(d, i){
      return d;
  });

这段代码也用到了一个无名函数 function(d, i)，其对应的状况以下：

• 当 i == 0 时， d 为 I like dogs。
• 当 i == 1 时， d 为 I like cats。
• 当 i == 2 时， d 为 I like snakes。

此时，三个段落元素与数组 dataset 的三个字符串是一一对应的，所以，在函数 function(d, i) 直接 return d 便可。

结果天然是三个段落的文字分别变成了数组的三个字符串。

I like dogs  I like cats  I like snakes