brush.event 动画刷事件时做什么?

What does brush.event do when animating brush events?

问题:

在查看 bl.ocks.org 上发布的 Brush Snapping 功能时,我被这段代码弄糊涂了:

var gBrush = svg.append("g")
        .attr("class", "brush")
        .call(brush)
        .call(brush.event);

明确地说,我理解 .call(brush.event) 的作用,但我不明白为什么它是 在这个特定的代码块 中。即,我看到在“brushended”事件处理程序中进行了相同的调用,但为什么 'brushend' 事件中的转换取决于上面复制的调用?


之前的研究:

我查看了API docs,里面说了下面的话,但我必须承认我不是很理解这个解释。

If selection is a transition, registers the appropriate tweens so that the brush dispatches events over the course of the transition

我需要一些帮助来解析调用 brush.event?

的细节机制

(我想知道的原因):

我想在 Meteor.js 应用程序中实现此功能。我发现,如果我注释掉这一行,滑块会卡入到位,但动画会丢失。但是,如果我保留该行,则根本不会显示画笔选择。我在询问这个动画的机制,以便弄清楚如何让它在我的流星项目中工作

更新:原来是package named "d3" on atmosphere is deprecated。如果我使用名为 d3.js:d3 的包,一切正常。


完整代码:

<!DOCTYPE html>
<meta charset="utf-8">
<style>

.axis text {
  font: 11px sans-serif;
}

.axis path {
  display: none;
}

.axis line {
  fill: none;
  stroke: #000;
  shape-rendering: crispEdges;
}

.grid-background {
  fill: #ddd;
}

.grid line,
.grid path {
  fill: none;
  stroke: #fff;
  shape-rendering: crispEdges;
}

.grid .minor.tick line {
  stroke-opacity: .5;
}

.brush .extent {
  stroke: #000;
  fill-opacity: .125;
  shape-rendering: crispEdges;
}

</style>
<body>
<script src="http://d3js.org/d3.v3.min.js"></script>
<script>

var margin = {top: 200, right: 40, bottom: 200, left: 40},
    width = 960 - margin.left - margin.right,
    height = 500 - margin.top - margin.bottom;

var x = d3.time.scale()
    .domain([new Date(2013, 7, 1), new Date(2013, 7, 15) - 1])
    .range([0, width]);

var brush = d3.svg.brush()
    .x(x)
    .extent([new Date(2013, 7, 2), new Date(2013, 7, 3)])
    .on("brushend", brushended);

var svg = d3.select("body").append("svg")
    .attr("width", width + margin.left + margin.right)
    .attr("height", height + margin.top + margin.bottom)
  .append("g")
    .attr("transform", "translate(" + margin.left + "," + margin.top + ")");

svg.append("rect")
    .attr("class", "grid-background")
    .attr("width", width)
    .attr("height", height);

svg.append("g")
    .attr("class", "x grid")
    .attr("transform", "translate(0," + height + ")")
    .call(d3.svg.axis()
        .scale(x)
        .orient("bottom")
        .ticks(d3.time.hours, 12)
        .tickSize(-height)
        .tickFormat(""))
  .selectAll(".tick")
    .classed("minor", function(d) { return d.getHours(); });

svg.append("g")
    .attr("class", "x axis")
    .attr("transform", "translate(0," + height + ")")
    .call(d3.svg.axis()
      .scale(x)
      .orient("bottom")
      .ticks(d3.time.days)
      .tickPadding(0))
  .selectAll("text")
    .attr("x", 6)
    .style("text-anchor", null);

var gBrush = svg.append("g")
    .attr("class", "brush")
    .call(brush)
    .call(brush.event);

gBrush.selectAll("rect")
    .attr("height", height);

function brushended() {
  if (!d3.event.sourceEvent) return; // only transition after input
  var extent0 = brush.extent(),
      extent1 = extent0.map(d3.time.day.round);

  // if empty when rounded, use floor & ceil instead
  if (extent1[0] >= extent1[1]) {
    extent1[0] = d3.time.day.floor(extent0[0]);
    extent1[1] = d3.time.day.ceil(extent0[1]);
  }

  d3.select(this).transition()
      .call(brush.extent(extent1))
      .call(brush.event);
}

</script>

关键在 API 文档中,就在您引用的位之前:

This can be useful in triggering listeners after setting the brush extent programatically.

在此特定示例中,调用 brush.event 是必要的,因为范围是通过编程设置的(这就是捕捉的实现方式)。如果不调用它,则显示的画笔范围将不会与为比例设置的内容相对应,因为范围将在画笔处理函数中进行调整并且永远不会更新。

但是,在您发布的 特定 部分代码中,您实际上不需要调用 brush.event -- 它只需要在画笔处理程序中调用函数(参见 example with that first call removed)。

现在开始过渡。首先,让我们看看删除它时会发生什么——参见 example here。画笔现在会卡住,而不是逐渐移动到位。否则没有区别。

您引用的文档部分基本上是说,为了使过渡正常进行,需要处理的所有事情都已完成。从技术上讲,转换让所有适当的听众知道它正在移动画笔,以便更新链接的显示(例如 this example 中的图表)。

就您的应用程序而言,听起来好像有其他东西在干扰画笔,即在过渡开始后(重新)设置状态。

更新:在转换期间调度的事件实际上不会触发您的处理程序,因为如果在 brushend 事件处理程序的第一行中出现这种情况,您将返回。调用 brush.event 时您正在做的是安装处理程序函数,而不是处理单个事件 -- 所有 之后调度的事件将被处理。