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
时您正在做的是安装处理程序函数,而不是处理单个事件 -- 所有 之后调度的事件将被处理。
问题:
在查看 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
时您正在做的是安装处理程序函数,而不是处理单个事件 -- 所有 之后调度的事件将被处理。