Dragging API

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

拖放是d3.js中最熟悉的概念之一。 本章详细介绍了拖动及其方法。

安装 (Installation)

我们可以使用以下脚本直接包含拖动API。

<script src = "https://d3js.org/d3-dispatch.v1.min.js"></script>
<script src = "https://d3js.org/d3-selection.v1.min.js"></script>
<script src = "https://d3js.org/d3-drag.v1.min.js"></script>

拖动API方法

以下是D3.js中一些最重要的拖动API方法。

  • d3.drag()
  • drag(selection)
  • drag.container([container])
  • drag.filter([filter])
  • drag.subject([subject])
  • drag.clickDistance([distance])
  • drag.on(typenames, [listener])
  • d3.dragDisable(window)
  • d3.dragEnable(window[, noclick])

现在让我们详细了解每一个。

d3.drag()

此方法用于创建新拖动。 您可以使用以下脚本调用此方法。

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

drag(selection)

此方法用于将拖动应用于指定的选择。 您可以使用selection.call调用此函数。 下面定义一个简单的例子。

d3.select(".node").call(d3.drag().on("drag", mousemove));

这里,应用于所选元素的拖动行为是通过selection.call。

drag.container([container])

它用于将容器设置为指定的拖动功能。 如果未指定容器,则返回当前访问者。 要使用Canvas拖动任何图形元素,可以将容器重新定义为自身。 它定义如下。

function container() {
   return this;
}

drag.filter([filter])

它用于为指定的函数设置过滤器。 如果未指定过滤器,则返回如下定义的当前过滤器。

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

drag.subject([subject])

它用于将主题设置为指定的拖动功能,并在下面定义。

function subject(d) {
   return d = =  null ? {x: d3.event.x, y: d3.event.y} : d;
}

这里,主题代表被拖动的东西。 例如,如果要在SVG中拖动矩形元素,则默认主题是要拖动的矩形的基准。

drag.clickDistance([distance])

此方法用于设置单击mousedown和mouseup事件的最大距离。 如果未指定距离,则指向零。

drag.on(typenames, [listener])

此方法用于为指定的类型名称设置事件侦听器以进行拖动。 类型名是一个包含一个或多个由空格分隔的类型名的字符串。 每个typename都是一个类型,可选地后跟句点(。)和名称,例如drag.one和drag.two。 此类型应来自以下之一 -

  • start - 启动一个新指针。

  • drag - 拖动活动指针。

  • end - 非活动指针。

d3.dragDisable(window)

此方法用于禁用拖放选择。 它可以防止mousedown事件操作。 默认情况下,大多数选定的浏览器都支持此操作。 如果不支持,则可以将CSS属性设置为none。

d3.dragEnable(window[, noclick])

此方法用于在指定的窗口位置上启用拖放选择。 它用于调用mouseup事件操作。 如果指定noclick值为true,则click事件将超过零毫秒超时。

拖动API - 拖动事件

D3.event方法用于设置拖动事件。 它包括以下字段 -

  • Target - 它表示拖动行为。

  • Type - 它是一个字符串,可以是以下任何一个 - “开始”,“拖动”或“结束”。

  • Subject - 拖动主题,由drag.subject定义。

event.on(typenames, [listener])

事件对象公开event.on方法以执行拖动。 它的定义如下。

d3.event.on("drag", dragged).on("end", ended);

最后更新:

类似资料

  • 视图移动以及缩放是一种将用户注意力聚焦在感兴趣区域的一种流行的交互技术。操作直接,容易理解: 点击并拖拽平移,使用滚轮进行缩放,当然也可以通过触摸进行。平移和缩放被广泛的应用在地图中,但是也可被应用到其他的可视化比如时间序列以及散点图中。 缩放行为通过 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 的其他特性一样,这些图形也是又数据驱动的: 每个图形生成器都暴露了一个如何将数据映射到可视化表现的访问器。例