选择 null:D3 中 selectAll(null) 背后的原因是啥?

Posted

技术标签:

【中文标题】选择 null:D3 中 selectAll(null) 背后的原因是啥?【英文标题】:Selecting null: what is the reason behind selectAll(null) in D3?选择 null:D3 中 selectAll(null) 背后的原因是什么? 【发布时间】:2018-02-19 04:41:26 【问题描述】:

我已经看到一些 D3 代码使用这样的模式来附加元素:

var circles = svg.selectAll(null)
    .data(data)
    .enter()
    .append("circle");

我真的不明白这个sn-p。为什么选择null

我理解D3的方式,如果是附加圆圈,应该是:

var circles = svg.selectAll("circle")
    .data(data)
    .enter()
    .append("circle");

同样的方法,如果要附加 html 段落,它应该是:

var circles = svg.selectAll("p")
    .data(data)
    .enter()
    .append("p");

对于类也是如此:如果添加带有 foo 类的元素,它应该是 selectAll(".foo")

但是,selectAll(null) 确实有效!元素被附加。

那么,null 是什么意思?我在这里错过了什么?


注意:这是一个自我回答的问题,trying to provide a "canonical" Q&A on a subject that has been touched on by many previous questions,API 没有解释。下面的大部分答案来自我在绝种*** Documentation中写的一个例子。

【问题讨论】:

【参考方案1】:

tl;博士

使用selectAll(null) 的目的是保证“输入”选择始终对应于数据数组中的元素,数据中的每个元素对应一个元素。


“进入”选择

为了回答您的问题,我们必须简要解释一下 D3.js 中的“输入”选择是什么。您可能知道,D3 的主要功能之一是binding data 对 DOM 元素的能力。

在 D3.js 中,当将数据绑定到 DOM 元素时,可能出现三种情况:

    元素个数和数据点个数相同; 元素多于数据点; 数据点多于元素;

在情况 #3 中,所有没有对应 DOM 元素的数据点都属于“输入”选择。

因此,在 D3.js 中,“输入”选择是在将元素连接到数据后,包含与任何 DOM 元素不匹配的所有数据的选择。如果我们在“输入”选择中使用附加函数,D3 将创建新元素,为我们绑定该数据。

这是一个维恩图,解释了有关数据点数量/DOM 元素数量的可能情况:

将数据绑定到现有的 DOM 元素

让我们打破你提议的附加圈子的 sn-p。

这...

var circles = svg.selectAll("circle")
    .data(data)

... 将数据绑定到包含所有圆圈的选择。在 D3 术语中,这就是“更新”选择。

那么,这个……

.enter()
.append("circle");

... 表示“输入”选择,为每个与所选元素不匹配的数据点创建一个圆圈。

Sure, when there is no element (or a given class) in the selection, using that element (or that class) in the selectAll method will work as intended.因此,在您的 sn-p 中,如果 svg 选择中没有 <circle> 元素,则可以使用 selectAll("circle") 为数据数组中的每个数据点附加一个圆圈。

这是一个简单的例子。 <body> 中没有 <p>,我们的“输入”选择将包含数据数组中的所有元素:

var body = d3.select("body");
var data = ["red", "blue", "green"];
var p = body.selectAll("p")
  .data(data)
  .enter()
  .append("p")
  .text(d=> "I am a " + d + " paragraph!")
  .style("color", String)
<script src="https://d3js.org/d3.v4.min.js"></script>

但是如果我们在该页面中已经有一个段落会发生什么?让我们看看:

var body = d3.select("body");
var data = ["red", "blue", "green"];
var p = body.selectAll("p")
  .data(data)
  .enter()
  .append("p")
  .text(d=> "I am a " + d + " paragraph!")
  .style("color", String)
<script src="https://d3js.org/d3.v4.min.js"></script>
<p>Look Ma, I'm a paragraph!</p>

结果一目了然:红色段落消失了!它在哪里?

第一个数据元素“red”绑定到已经存在的段落。然后,只创建了两个段落(我们的“输入”选择),蓝色的和绿色的。

发生这种情况是因为,当我们使用 selectAll("p") 时,我们选择了,嗯,&lt;p&gt; 元素!并且该页面中已经有一个 &lt;p&gt; 元素。

选择空

但是,如果我们使用selectAll(null),则会选择nothing!该页面中已经有一个段落并不重要,我们的“输入”选择将始终包含数据数组中的所有元素。

让我们看看它的工作原理:

var body = d3.select("body");
var data = ["red", "blue", "green"];
var p = body.selectAll(null)
  .data(data)
  .enter()
  .append("p")
  .text(d=> "I am a " + d + " paragraph!")
  .style("color", String)
<script src="https://d3js.org/d3.v4.min.js"></script>
<p>Look Ma, I'm a paragraph!</p>

这就是选择 null 的目的:我们保证所选元素与数据数组之间存在不匹配

选择空值和性能

由于我们没有选择任何内容,selectAll(null) 是迄今为止添加新元素的最快方式:我们不必遍历 DOM 搜索任何内容。

这是一个比较,使用jsPerf:

https://jsperf.com/selecting-null/1

在这个非常简单的场景中,selectAll(null) 的速度要快得多。在一个充满 DOM 元素的真实页面中,差异可能更大。

何时不使用 selectAll(null)

正如我们刚刚解释的,selectAll(null) 不会匹配任何现有的 DOM 元素。对于始终附加数据数组中的所有元素的快速代码来说,这是一个很好的模式。

但是,如果您打算更新您的元素,也就是说,如果您打算进行“更新”(和“退出”)选择,不要使用selectAll(null)。在这种情况下,请选择您计划更新的元素(或类)。

所以,如果你想根据不断变化的数据数组更新圆,你可以这样做:

//this is the "update" selection
var circles = svg.selectAll("circle")
    .data(data);

//this is the "enter" selection
circles.enter()
    .append("circle")
    .attr("foo", ...

//this is the "exit" selection
circles.exit().remove();

//updating the elements
circles.attr("foo", ...

在这种情况下,如果您使用selectAll(null),圆圈将不断地附加到所选内容中,堆积起来,并且不会删除或更新任何圆圈。


PS:正如历史的好奇,selectAll(null) 模式的创建可以追溯到 Mike Bostock 和其他人的这些 cmets:https://github.com/d3/d3-selection/issues/79

【讨论】:

以上是关于选择 null:D3 中 selectAll(null) 背后的原因是啥?的主要内容,如果未能解决你的问题,请参考以下文章

D3的简单语法

html D3:选择器,d3.select,.selectAll,.data:向DOM元素添加数据

D3 入门笔记

D3——动态绑定数据

D3.js 入门系列 --- 2.1 关于如何选择,插入,删除元素

D3.js 入门系列 --- 2.1 关于怎样选择,插入,删除元素