logo

X6

  • 文档
  • API
  • 图表示例
  • 常见问题
  • 更新日志
  • XFlow
  • 所有产品antv logo arrow
  • 2.x
  • 画布
    • 画布
    • 网格
    • 背景
    • 画布平移
    • 画布缩放
    • 视口变换
    • 坐标系
  • 元素
    • 元素
    • 节点
    • 边
    • 标签
    • 箭头
    • 元素属性
    • 交互
  • MVC
    • 模型
    • 视图
  • 扩展
    • 节点工具
    • 边上工具
    • 路由
    • 连接器
    • 节点的锚点
    • 边的锚点
    • 连接点
    • 连接桩布局
    • 连接桩标签布局
    • 属性
    • 高亮器
    • 滤镜

画布平移

上一篇
背景
下一篇
画布缩放

Resources

Ant Design
Galacea Effects
Umi-React 应用开发框架
Dumi-组件/文档研发工具
ahooks-React Hooks 库

社区

体验科技专栏
seeconfSEE Conf-蚂蚁体验科技大会

帮助

GitHub
StackOverflow

more products更多产品

Ant DesignAnt Design-企业级 UI 设计语言
yuque语雀-知识创作与分享工具
EggEgg-企业级 Node 开发框架
kitchenKitchen-Sketch 工具集
GalaceanGalacean-互动图形解决方案
xtech蚂蚁体验科技
© Copyright 2025 Ant Group Co., Ltd..备案号:京ICP备15032932号-38

Loading...

演示

Selection Settings
Enabled
Modifier Key
Event Type

配置

普通画布(未使用 scroller 插件)通过开启 panning 选项来支持拖拽平移。

注意

不要同时使用 scroller 和 panning,因为两种形式在交互上有冲突。

const graph = new Graph({
panning: true,
})
// 等同于
const graph = new Graph({
panning: {
enabled: true,
},
})

支持的选项如下:

interface Options {
enabled?: boolean
modifiers?: ModifierKey
eventTypes?: ('leftMouseDown' | 'rightMouseDown' | 'mouseWheel', 'mouseWheelDown')[]
}

enabled

是否开启画布平移交互。

modifiers

拖拽可能和其他操作冲突,此时可以设置 modifiers 参数,设置修饰键后需要按下修饰键并点击鼠标才能触发画布拖拽。

ModifierKey 的类型定义如下:

type ModifierKey = string | ('alt' | 'ctrl' | 'meta' | 'shift' | 'space')[] | null

支持以下几种形式:

  • alt 表示按下 alt。
  • [alt, ctrl] 表示按下 alt 或 ctrl。
  • alt|ctrl 表示按下 alt 或 ctrl。
  • alt&ctrl 表示同时按下 alt 和 ctrl。
  • alt|ctrl&shift 表示同时按下 alt 和 shift 或者同时按下 ctrl 和 shift。

eventTypes

触发画布平移的交互方式。支持三种形式或者他们之间的组合:

  • leftMouseDown: 按下鼠标左键移动进行拖拽
  • rightMouseDown: 按下鼠标右键移动进行拖拽
  • mouseWheel: 使用鼠标滚轮滚动拖拽
  • mouseWheelDown: 按下鼠标滚轮进行拖拽

方法

isPannable()

isPannable(): boolean

返回是否启用了画布平移交互功能。

enablePanning()

enablePanning(): this

启用画布平移功能。

disablePanning()

disablePanning(): this

禁用画布平移功能。

togglePanning(...)

togglePanning(enabled?: boolean): this

切换画布平移启用状态。参数如下:

名称类型必选默认值描述
enabledboolean-是否启用画布平移功能,缺省时切换画布平移的启用状态。