Zooming API

优质
小牛编辑
132浏览
2023-12-01

缩放有助于扩展您的内容。 您可以使用单击并拖动方法专注于特定区域。 在本章中,我们将详细讨论Zooming API。

配置API (Configuring API)

您可以使用以下脚本直接从“d3js.org”加载Zooming API。

<script src = "https://d3js.org/d3-color.v1.min.js"></script>
<script src = "https://d3js.org/d3-dispatch.v1.min.js"></script>
<script src = "https://d3js.org/d3-ease.v1.min.js"></script>
<script src = "https://d3js.org/d3-interpolate.v1.min.js"></script>
<script src = "https://d3js.org/d3-selection.v1.min.js"></script>
<script src = "https://d3js.org/d3-timer.v1.min.js"></script>
<script src = "https://d3js.org/d3-transition.v1.min.js"></script>
<script src = "https://d3js.org/d3-drag.v1.min.js"></script>
<script src = "https://d3js.org/d3-zoom.v1.min.js"></script>
<body>
   <script>
   </script>
</body>

缩放API方法

以下是一些最常用的Zooming API方法。

  • d3.zoom()
  • zoom(selection)
  • zoom.transform(selection, transform)
  • zoom.translateBy(selection, x, y)
  • zoom.translateTo(selection, x, y)
  • zoom.scaleTo(selection, k)
  • zoom.scaleBy(selection, k)
  • zoom.filter([filter])
  • zoom.wheelDelta([delta])
  • zoom.extent([extent])
  • zoom.scaleExtent([extent])
  • zoom.translateExtent([extent])
  • zoom.clickDistance([distance])
  • zoom.duration([duration])
  • zoom.interpolate([interpolate])
  • zoom.on(typenames[, listener])

让我们简要介绍所有这些Zooming API方法。

d3.zoom()

它会创建一个新的缩放行为。 我们可以使用下面的脚本访问它。

<script>
   var zoom = d3.zoom();
</script>

zoom(selection)

它用于对选定元素应用缩放变换。 例如,您可以使用以下语法实例化mousedown.zoom行为。

selection.call(d3.zoom().on("mousedown.zoom", mousedowned));

zoom.transform(selection, transform)

它用于将所选元素的当前缩放变换设置为指定的变换。 例如,我们可以使用以下语法将缩放变换重置为标识变换。

selection.call(zoom.transform, d3.zoomIdentity);

我们还可以使用以下语法将缩放变换重置为标识变换1000毫秒。

selection.transition().duration(1000).call(zoom.transform, d3.zoomIdentity);

zoom.translateBy(selection, x, y)

它用于通过x和y值转换所选元素的当前缩放变换。 您可以将x和y转换值指定为数字或返回数字的函数。 如果为所选元素调用了一个函数,那么它将通过DOM的当前数据“d”和索引“i”传递。 示例代码定义如下。

zoom.translateBy(selection, x, y) {
   zoom.transform(selection, function() {
      return constrain(this.__zoom.translate(
         x = = = "function" ? x.apply(this, arguments) : x,
         y = = = "function" ? y.apply(this, arguments) : y
      );
   }
};

zoom.translateTo(selection, x, y)

它用于将所选元素的当前缩放变换转换为x和y的指定位置。

zoom.scaleTo(selection, k)

它用于将所选元素的当前缩放变换缩放为k 。 这里, k是比例因子,指定为数字或函数。

zoom.scaleTo = function(selection, k) {
   zoom.transform(selection, function() {
      k = = = "function" ? k.apply(this, arguments) : k;
   });
};

zoom.scaleBy(selection, k)

它用于通过k缩放所选元素的当前zoon变换。 这里, k是比例因子,指定为数字或返回数字的函数。

zoom.scaleBy = function(selection, k) {
   zoom.scaleTo(selection, function() {
      var k0 = this.__zoom.k,
      k1 = k = = = "function" ? k.apply(this, arguments) : k;
      return k0 * k1;
   });
};

zoom.filter([filter])

它用于将过滤器设置为指定的缩放行为功能。 如果未指定过滤器,则返回当前过滤器,如下所示。

function filter() {
   return !d3.event.button;
}

zoom.wheelDelta([delta])

Δ值由轮三角函数返回。 如果未指定delta,则返回当前车轮增量功能。

zoom.extent([extent])

它用于将范围设置为指定的数组点。 如果未指定范围,则返回当前范围访问器,默认为[[0,0],[width,height]],其中width是元素的客户端宽度,height是其客户端高度。

zoom.scaleExtent([extent])

它用于将比例范围设置为指定的数字数组[k0,k1]。 这里, k0是允许的最小比例因子。 而k1是允许的最大比例因子。 如果未指定extent,则返回当前缩放范围,默认为[0,∞]。 考虑下面定义的示例代码。

selection
   .call(zoom)
   .on("wheel", function() { d3.event.preventDefault(); });

当已经处于比例范围的相应极限时,用户可以尝试通过转动进行缩放。 如果我们想要阻止滚轮输入而不管刻度范围,请注册滚轮事件侦听器以防止浏览器默认行为。

zoom.translateExtent([extent])

如果指定了范围,则将translate范围设置为指定的点数组。 如果未指定extent,则返回当前平移范围,默认为[[-∞,-∞],[+∞,+∞]]。

zoom.clickDistance([distance])

此方法用于设置可缩放区域在向上和向下之间移动的最大距离,这将触发后续单击事件。

zoom.duration([duration])

此方法用于在双击时设置缩放过渡的持续时间,并双击到指定的毫秒数并返回缩放行为。 如果未指定持续时间,则返回当前持续时间,默认为250毫秒,具体定义如下。

selection
   .call(zoom)
   .on("dblclick.zoom", null);

zoom.interpolate([interpolate])

此方法用于内插缩放过渡到指定的函数。 如果未指定interpolate,则返回当前插值工厂,默认为d3.interpolateZoom。

zoom.on(typenames[, listener])

如果指定了侦听器,它将为指定的类型名设置事件侦听器并返回缩放行为。 类型名是一个包含一个或多个由空格分隔的类型名的字符串。 每个typename都是一个类型,可选地后跟句点(。)和名称,例如zoom.one和zoom.second。 该名称允许为同一类型注册多个侦听器。 此类型必须来自以下之一 -

  • Start - 缩放开始后(例如在mousedown上)。

  • Zoom - 更改缩放变换后(例如在mousemove上)。

  • End - 缩放结束后(例如鼠标上)。

在下一章中,我们将讨论D3.js中的不同请求API。

最后更新:

类似资料

  • 视图移动以及缩放是一种将用户注意力聚焦在感兴趣区域的一种流行的交互技术。操作直接,容易理解: 点击并拖拽平移,使用滚轮进行缩放,当然也可以通过触摸进行。平移和缩放被广泛的应用在地图中,但是也可被应用到其他的可视化比如时间序列以及散点图中。 缩放行为通过 d3-zoom 模块实现,能方便且灵活到 selections 上。它处理了许多 Installing NPM 安装: npm install d

  • 这个模块实现了用来计算一组二维点 Voronoi diagram(泰森多边形) 或 Delaunay triangulation(德劳内三角剖分) 的 Steven J. Fortune’s algorithm 算法。这个模块的实现大多是基于 Raymond Hill 的工作。 泰森多边形不仅仅在视觉上具有吸引力,在交互方面也非常实用,比如在散点图中增加点的目标面积。参考 “Strikeouts

  • transition 是一个类 selection 的接口,用来对 DOM 进行动画修改。这种修改不是立即修改,而是在规定的事件内平滑过渡到目标状态。 应用过渡,首先要选中元素,然后调用 selection.transition,并且设置期望的改变,例如: d3.select("body") .transition() .style("background-color", "red")

  • 这个模块提供了一个高效的队列,能管理上千并发动画同时保证与并发或分段动画一致的同步时序。在内部使用 requestAnimationFrame 进行 fluid animation(如果支持的话),否则切换使用 setTimeout来实现。 Installing NPM 安装: npm install d3-timer. 此外还可以下载 latest release。也可以直接从 d3js.org

  • 在可视化时间序列数据、分析时间模式或处理一般时间时,常规时间单位的不规则性很快就变得明显起来。在 Gregorian calendar(公历) 中,大多数月份有 31 天但是有些月份只有 28 或者 29、30 天。大多数年份有 365 天但是 leap years(闰年) 有 366 天。在 daylight saving(夏令时) 中一天可能有 23 25 小时。更复杂的是世界各地的夏时制不同

  • 可视化通常由离散图形标记组成, 比如 symbols, arcs, lines 和 areas。虽然条形的矩形可以很容易的使用 SVG 或者 Canvas 来生成, 但是其他的比如圆形的扇形以及向心 Catmull-Rom 样条曲线就很复杂。这个模块提供了许多图形生成器以便使用。 与 D3 的其他特性一样,这些图形也是又数据驱动的: 每个图形生成器都暴露了一个如何将数据映射到可视化表现的访问器。例