【D3.js - v5.x】(1)选择集 | 绑定数据 | 插入元素 | 删除元素

2023-10-07 18:59:00 浏览数 (2)

选择集

使用 d3.select() 或 d3.selectAll() 选择元素后返回的对象,就是选择集

D3 能够连续不断地调用函数,形如:

d3.select().selectAll().text()

这称为链式语法,和 JQuery 的语法很像.

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

这两个函数返回的结果称为选择集。

例如:

代码语言:javascript复制
var body = d3.select("body"); //选择文档中的body元素
var p1 = body.select("p");      //选择body中的第一个p元素
var p = body.selectAll("p");    //选择body中的所有p元素
代码语言:javascript复制
var svg = body.select("svg");   //选择body中的svg元素
var rects = svg.selectAll("rect");  //选择svg中所有的svg元素

绑定数据

D3 有一个很独特的功能:能将数据绑定到 DOM 上,也就是绑定到文档上。

例如网页中有段落元素 p 和一个整数 5,于是可以将整数 5 与 p 绑定到一起。绑定之后,当需要依靠这个数据才操作元素的时候,会很方便。

D3 中是通过以下两个函数来绑定数据的:

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

相对而言,data() 比较常用。

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

datum()
代码语言:javascript复制
<body>
    <p>Apple</p>
    <p>Pear</p>
    <p>Banana</p>
    <script src="d3/d3.js"></script>
    <script>
        var str = "China";
        var body = d3.select("body");
        var p = body.selectAll("p");
        p.datum(str);
        p.text(function(d, i){
            return "第 "  i   " 个元素绑定的数据是 "   d;
        });
    </script>
</body>

结果:

代码语言:javascript复制
第 0 个元素绑定的数据是 China

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

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

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

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

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

data()

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

代码语言:javascript复制
var dataset = ["I like dog","I like cat","I like snake"];

绑定之后,其对应关系的要求为:

  • Apple 与 I like dog 绑定;
  • Pear 与 I like cat 绑定;
  • Banana 与 I like snake 绑定;

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

代码语言:javascript复制
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 dog。
  • 当 i == 1 时, d 为 I like cat。
  • 当 i == 2 时, d 为 I like snake。

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

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

代码语言:javascript复制
I like dog

I like cat

I like snake

选择元素

上一章已经讲解了 select 和 selectAll,以及选择集的概念。关于 select 和 selectAll 的参数,其实是符合 CSS 选择器的条件的,即用“井号(#)”表示 id,用“点(.)”表示 class。

此外,对于已经绑定了数据的选择集,还有一种选择元素的方法,那就是灵活运用 function(d, i)。我们已经知道参数 i 是代表索引号的,于是便可以用条件判定语句来指定执行的元素。

插入元素

插入元素涉及的函数有两个:

  • append():在选择集末尾插入元素
  • insert():在选择集前面插入元素
append()
代码语言:javascript复制
d3.select('body').append("p")
        .text("append p element");
insert()
代码语言:javascript复制
<body>
    <p class="myid">Apple</p>
    <p>Pear</p>
    <p>Banana</p>
    <script src="d3/d3.js"></script>
    <script>
        d3.select('body').insert("p",".myid")
        .text("append p element");
    </script>
</body>

结果:

代码语言:javascript复制
append p element

Apple

Pear

Banana

删除元素

删除一个元素时,对于选择的元素,使用 remove 即可,例如:

代码语言:javascript复制
d3.select('body').select(".myid").remove()

删除指定 class 的段落元素。

0 人点赞