D3.js学习笔记(一)——DOM上的数据绑定 – 楚狂人 – 博客园

开始学习D3.js,网上没有找到很满意的中文教程,但是发现了一个很好的英文教程,讲解的非常详细。从一个初始简单的HTML网页开始,逐步加入D3.js的应用,几乎是逐句讲解。学习的时候,就顺便翻译成中文,来和大家分享 。当然,更推荐看英文原文教程了,点击这里。

https://www.dashingd3js.com/binding-data-to-dom-elements

 简单例子

在这个例子中,你将会使用D3.js来把数据绑定到简单网页的DOM元素(DOM element)上。

现在开始了!下面是一个简单的HTML网页:

复制代码
<span style="color: #008080;">1</span> <span style="color: #0000ff;">&lt;!</span><span style="color: #ff00ff;">DOCTYPE html</span><span style="color: #0000ff;">&gt;</span>

2 <html>

3 <head>

4 <script type=”text/javascript” src=”d3.v3.min.js”></script>

5 </head>

6 <body>

7 </body>

8 </html>

复制代码

打开Chrome的开发者工具进入JavaScript控制台,观察元素查阅器(inspector)。

在JavaScript控制台上输入下面这段代码:

复制代码
<span style="color: #008080;">1</span> <span style="color: #0000ff;">var</span> theData = [1,2,3]  <span style="color: #008000;">//</span><span style="color: #008000;">一个数组</span>

2

3 var p = d3.select(“body”).selectAll(“p”)

4 .data(theData)

5 .enter()

6 .append(“p”)

7 .text(“hello”);

复制代码

结果如下:

binding-data-to-dom-element

恭喜你!你现在已经成功使用D3.js把一些数据绑定到了DOM元素上了!

D3.js 的 SelectAll 方法

在上面那段Javascript代码中,有一个方法是:.selectAll(“p”).

D3.js中的selectAll方法使用的是CSS3中的选择器来获取DOM元素。不同于select方法(该方法获取的是第一个目标元素),而selectAll方法选择的是所有匹配的元素。

但是!!初识的HTML网页中并不包含<p>,也就是说,该方法返回的是一个空的选择结果(selection)。

在此之后呢,我们又使用了.data(theData)和.enter()把数据绑定到这个空的选择结果中,这是怎么回事呢?

D3.js的data操作符(operator)

在上面那段Javascript代码中,接下来的是.data(theData)。

这个data操作符是把一个数据数组(可能是数值数组、对象数组或者别的什么数组)与当前的选择结果联系(join)起来。

在本例中,并没有提供key值,因此theData数组中的每一个元素都被分配到当前选择结果中的一个元素上。数组中第一个元素,也就是数字1,被分配到第一个<p>元素,第二个元素2被分配到相应的第二个<p>,以此类推。

但是!!正如上面说过的,初识网页中根本没有一个<p>,那么到底怎么回事?

D3.js的Virtual Selections

与D3.js中的其他方法不同的是,data操作符返回的是三个Virtual selection。

这三个virtual selection是enter,update以及exit

enter选集:对所有缺失的元素以占位符placeholder替代。

update选集:包含现有的元素,并绑定到数据

剩下的元素最终都会出现在exit选集中,并被移除。

由于从下面代码得到的选集是空的:

 

<span style="color: #008080;">1</span> d3.select("body").selectAll("p")

 

因此,虚拟enter选集中包含的是<p>元素的占位符。

我们将会的后面章节继续讨论虚拟选集enter,update,exit,而现在,我们就把焦点放在enter虚拟选集上。

如果想要了解更多虚拟选集(virtual selection)知识,这里推荐一篇经典文章:Mike Bostock 写的”Thinking with Joins”。

 D3.js的enter方法

D3.js的enter方法从data操作符返回一个虚拟选集。这个方法只能作用于data操作符,因为只有data操作符返回的是三个虚拟选集。

 

<span style="color: #008080;">1</span> <span style="color: #0000ff;">var</span> p = d3.select("body").selectAll("p"<span style="color: #000000;">)</span>

2 .data(theData)

3 .enter()

 

正如前面所说,对于数组中的数据元素,如果缺少与之对应的DOM元素,那么就会有一个占位符来顶替,而enter方法返回的就是这些占位符集合的引用(reference)。

得到这个引用之后,就能对该集合操作了。

在这里需要特别注意的是,这个引用后只能链接(chaining)append,insert以及select操作符,通过他们来操作该引用所指向的集合。

在这些操作符链接到.enter()选集,我们就可以像处理其他选集那样,来对其内容进行更改。

D3.js的Append操作符

我们再次来看看这段代码:

 

<span style="color: #008080;">1</span> <span style="color: #0000ff;">var</span> p = d3.select("body").selectAll("p"<span style="color: #000000;">)</span>

2 .data(theData)

3 .enter()

4 .append(“p”)

 

我们把.append(“p”)作用于.enter()选集之上。

对上一步中所产生的每个占位符(placeholder),都有一个P元素插入进去。

由于在我们的数据数组中,有三个数据元素(1,2,3),但是在网页中,没有一个P元素,所以.append(“p”)就创建并加入了3个段落元素。

在本例中,当我们对.enter()的选集使用了append操作符之后,返回的是一个具有3个HTML段落元素的选集。

D3.js的text操作符

如果我们把之前那段Javascript代码做一改变,去掉text操作符:

 

<span style="color: #008080;">1</span> <span style="color: #0000ff;">var</span> theData = [1,2,3<span style="color: #000000;">]</span>

2

3 var p = d3.select(“body”).selectAll(“p”)

4 .data(theData)

5 .enter()

6 .append(“p”);

 

我们得到的结果是:

Text operator

我们注意到,与之前的那张图片相对比,这里的段落都是不包含任何文字的。

text操作符对所有被选择的元素的textContent属性进行赋值。

在本例中,.text(“hello”),值是“hello”。因为我们的选集中有3个<p>元素,因此每个元素都被插入了“hello”。

数据到哪儿去了?

在本文的例子中,一开始就是一个Javascript的数据数组:

 

<span style="color: #008080;">1</span> <span style="color: #0000ff;">var</span> theData = [1,2,3]

 

可是到最后,我们得到了三个内容是“hello”的段落。

那么对于数字1,2,3,发生了什么?

D3.js的data操作符回顾

让我们通过一个简单的例子,在javascript控制台中再次观察下data操作符:

 

<span style="color: #008080;">1</span> console.log(d3.select("body"));

 

当我们点击回车,然后点击向下的箭头来查看“body”的属性,你看到的应该如下:

data reviewed

 

在0:<body>这一行下面,你可以看到HTML中body元素的属性。

现在,我们在Javascript控制台运行一下下面这句代码,我们加入了.data()操作符。

 

<span style="color: #008080;">1</span> console.log(d3.select("body").data([1]));

 

我们的数据出现在名为_data_的属性中:

data revisited

当我们把数据分配到一个元素上时,这个数据被存储到_data_属性中。

到此,数据可以通过_data_属性被再选。这也就是我们所说的数据绑定到Dom元素(Binding Data to Dom Elements)。

初始例子回顾

回顾我们在页面最上方提到的那个例子,现在我们使用console.log()来查看数据绑定到什么地方了:

复制代码
<span style="color: #008080;">1</span> <span style="color: #0000ff;">var</span> theData = [1,2,3<span style="color: #000000;">]</span>

2

3 var p = d3.select(“body”).selectAll(“p”)

4 .data(theData)

5 .enter()

6 .append(“p”)

7 .text(“love”)

8

9 console.log(p);

复制代码

结果是:

example revisited

从上图可以看出3个段落元素被添加。

你还会看到最后一个(第三个)段落元素的_data_属性值为3,这个值就是来自我们的数据集theData!

来源URL:http://www.cnblogs.com/winleisure/p/3512890.html