logo

S2

  • 使用文档
  • API 文档
  • 图表示例
  • 在线体验
  • 更新日志
  • 所有产品antv logo arrow
  • 2.x
  • 基础配置项
    • S2DataConfig
    • S2Options
      Updated
    • S2Theme
      Updated
    • S2Event
      Updated
  • 基础类
    • SpreadSheet
      Updated
    • Interaction
      Updated
    • Store
    • BaseCell
      Updated
    • BaseDataSet
      Updated
    • Node
    • BaseTooltip
    • BaseFacet
      Updated
    • Hierarchy
      New
    • BaseBBox
      New
    • CellData
      New
  • 分析组件
    • 表组件
      Updated
    • 维度下钻
      Updated
    • 维度切换组件
      Updated
    • 高级排序
      Updated
    • 导出
      Updated
  • 绘图属性
  • 透视组合图拓展 S2Options

S2Event

上一篇
S2Theme
下一篇
SpreadSheet

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...

表格事件列表,可以根据实际需要,监听所需事件,实现自定义业务。查看全部事件定义, 文档 和 示例

提示

如果使用的是 s2-react 或 s2-vue 表组件,则已对事件进行封装,无需额外监听,使用其回调函数即可。 详情

<SheetComponent onRowCellClick={...} />
import { S2Event } from '@antv/s2'
s2.on(S2Event.ROW_CELL_CLICK, (event) => {
console.log('rowCellClick', event)
});

行头单元格 (RowCell)

名称事件名描述
展开收起S2Event.ROW_CELL_COLLAPSED树状结构下,行头单元格展开/收起
全部展开/收起S2Event.ROW_CELL_ALL_COLLAPSED树状结构下,行头单元格全部展开/收起
点击S2Event.ROW_CELL_CLICK行头单元格点击
双击S2Event.ROW_CELL_DOUBLE_CLICK行头单元格双击
右键S2Event.ROW_CELL_CONTEXT_MENU行头单元格右键
悬停S2Event.ROW_CELL_HOVER行头单元格悬停
鼠标按下S2Event.ROW_CELL_MOUSE_DOWN行头单元格鼠标按下
鼠标移动S2Event.ROW_CELL_MOUSE_MOVE行头单元格鼠标移动
鼠标松开S2Event.ROW_CELL_MOUSE_UP行头单元格鼠标松开
滚动S2Event.ROW_CELL_SCROLL行头单元格滚动
行头刷选S2Event.ROW_CELL_BRUSH_SELECTION批量选中刷选范围内的行头单元格,刷选过程中,显示刷选范围提示蒙层,刷选完成后,弹出 tooltip, 展示被刷选单元格信息(仅支持透视表)
单元格渲染S2Event.ROW_CELL_RENDER行头单元格布局渲染完成事件
单元格选中S2Event.ROW_CELL_SELECTED行头单元格选中,可以获取到选中的单元格,交互名,和触发单元格等信息

列头单元格 (ColCell)

名称事件名描述
点击S2Event.COL_CELL_CLICK列头单元格点击
双击S2Event.COL_CELL_DOUBLE_CLICK列头单元格双击
右键S2Event.COL_CELL_CONTEXT_MENU列头单元格右键
悬停S2Event.COL_CELL_HOVER列头单元格悬停
鼠标按下S2Event.COL_CELL_MOUSE_DOWN列头单元格鼠标按下
鼠标移动S2Event.COL_CELL_MOUSE_MOVE列头单元格鼠标移动
鼠标松开S2Event.COL_CELL_MOUSE_UP列头单元格鼠标松开
列头刷选S2Event.COL_CELL_BRUSH_SELECTION批量选中刷选范围内的列头单元格,刷选过程中,显示刷选范围提示蒙层,刷选完成后,弹出 tooltip, 展示被刷选单元格信息(仅支持透视表)
单元格渲染S2Event.COL_CELL_RENDER列头单元格布局渲染完成事件
单元格选中S2Event.COL_CELL_SELECTED列头单元格选中,可以获取到选中的单元格,交互名,和触发单元格等信息

数值单元格 (DataCell)

名称事件名描述
点击S2Event.DATA_CELL_CLICK数值单元格点击
双击S2Event.DATA_CELL_DOUBLE_CLICK数值单元格双击
右键S2Event.DATA_CELL_CONTEXT_MENU数值单元格右键
悬停S2Event.DATA_CELL_HOVER数值单元格悬停
鼠标按下S2Event.DATA_CELL_MOUSE_DOWN数值单元格鼠标按下
鼠标移动S2Event.DATA_CELL_MOUSE_MOVE数值单元格鼠标移动
鼠标松开S2Event.DATA_CELL_MOUSE_UP数值单元格鼠标松开
刷选S2Event.DATA_CELL_BRUSH_SELECTION数值单元格刷选
键盘方向键移动S2Event.DATA_CELL_SELECT_MOVE数值单元格键盘方向键移动
单元格渲染S2Event.DATA_CELL_RENDER数值单元格布局渲染完成事件
单元格选中S2Event.DATA_CELL_SELECTED数值单元格选中,可以获取到选中的单元格,交互名,和触发单元格等信息

角头单元格 (CornerCell)

名称事件名描述
点击S2Event.CORNER_CELL_CLICK角头单元格点击
双击S2Event.CORNER_CELL_DOUBLE_CLICK角头单元格双击
右键S2Event.CORNER_CELL_CONTEXT_MENU角头单元格右键
悬停S2Event.CORNER_CELL_HOVER角头单元格悬停
鼠标按下S2Event.CORNER_CELL_MOUSE_DOWN角头单元格鼠标按下
鼠标移动S2Event.CORNER_CELL_MOUSE_MOVE角头单元格鼠标移动
鼠标松开S2Event.CORNER_CELL_MOUSE_UP角头单元格鼠标松开
单元格渲染S2Event.CORNER_CELL_RENDER角头单元格布局渲染完成事件
单元格选中S2Event.CORNER_CELL_SELECTED角头单元格选中,可以获取到选中的单元格,交互名,和触发单元格等信息

合并单元格 (MergedCells)

名称事件名描述
点击S2Event.MERGED_CELLS_CLICK合并单元格点击
双击S2Event.MERGED_CELLS_DOUBLE_CLICK合并单元格双击
右键S2Event.MERGED_CELLS_CONTEXT_MENU合并单元格右键
悬停S2Event.MERGED_CELLS_HOVER合并单元格悬停
鼠标按下S2Event.MERGED_CELLS_MOUSE_DOWN合并单元格鼠标按下
鼠标移动S2Event.MERGED_CELLS_MOUSE_MOVE合并单元格鼠标移动
鼠标松开S2Event.MERGED_CELLS_MOUSE_UP合并单元格鼠标松开
单元格渲染S2Event.MERGED_CELLS_RENDER合并单元格布局渲染完成事件

序号单元格 (SeriesNumberCell)

名称事件名描述
单元格渲染S2Event.SERIES_NUMBER_CELL_RENDER序号单元格布局渲染完成事件

宽高拖拽调整

名称事件名描述
单元格调整S2Event.LAYOUT_RESIZE单元格宽高发生改变
序号列宽度改变S2Event.LAYOUT_RESIZE_SERIES_WIDTH序号列宽度改变
调整单元格大小时鼠标按下S2Event.LAYOUT_RESIZE_MOUSE_DOWN调整单元格大小鼠标按下,目前仅 行/列 头有效
调整单元格大小时鼠标移动S2Event.LAYOUT_RESIZE_MOUSE_MOVE调整单元格大小鼠标移动,目前仅 行/列 头有效
调整单元格大小时鼠标松开S2Event.LAYOUT_RESIZE_MOUSE_UP调整单元格大小鼠标松开,目前仅 行/列 头有效
行头宽度改变S2Event.LAYOUT_RESIZE_ROW_WIDTH
行头高度改变S2Event.LAYOUT_RESIZE_ROW_HEIGHT
列头宽度改变S2Event.LAYOUT_RESIZE_COL_WIDTH
列头高度改变S2Event.LAYOUT_RESIZE_COL_HEIGHT
树状结构宽度改变S2Event.LAYOUT_RESIZE_TREE_WIDTH树状模式下,单元格宽度发生改变时触发

布局

名称事件名描述
表头布局完成S2Event.LAYOUT_AFTER_HEADER_LAYOUT行头和列头布局完成后触发
数值单元格布局完成S2Event.LAYOUT_AFTER_REAL_DATA_CELL_RENDER当前可视范围数值单元格渲染完成后触发
分页S2Event.LAYOUT_PAGINATION分页事件
列头展开S2Event.COL_CELL_EXPANDED列头展开时触发
列头隐藏S2Event.COL_CELL_HIDDEN列头隐藏时触发
列头展开 icon 悬停S2Event.COL_CELL_EXPAND_ICON_HOVER鼠标悬停在列头隐藏后的展开 icon 上时触发
开始渲染S2Event.LAYOUT_BEFORE_RENDER开始 render 前的事件,即 s2.render()
渲染完成S2Event.LAYOUT_AFTER_RENDERrender 完成的事件,即 s2.render()
表格销毁S2Event.LAYOUT_DESTROY表格销毁后或 调用 s2.destroy() 触发
单元格渲染S2Event.LAYOUT_CELL_RENDER单个单元格布局渲染完成事件

全局

名称事件名描述
键盘按下S2Event.GLOBAL_KEYBOARD_DOWN键盘按下
键盘松开S2Event.GLOBAL_KEYBOARD_UP键盘松开
复制S2Event.GLOBAL_COPIED对选中的单元格复制
鼠标松开S2Event.GLOBAL_MOUSE_UP图表区域鼠标松开
点击S2Event.GLOBAL_CLICK图表区域点击
图片/视频预览点击S2Event.GLOBAL_PREVIEW_CLICK图片/视频预览点击
右键S2Event.GLOBAL_CONTEXT_MENU图表区域按下右键 (禁用右键菜单不生效?)
选中S2Event.GLOBAL_SELECTED选中单元格时,如:刷选,多选,单选 (可以获取到选中的单元格,交互名,和触发单元格等信息)
悬停S2Event.GLOBAL_HOVER鼠标悬停在单元格
重置S2Event.GLOBAL_RESET点击空白处,按下 Esc 键 重置交互样式时
链接跳转S2Event.GLOBAL_LINK_FIELD_JUMP点击(行头/列头/数值)为链接字段的文本时
icon 点击S2Event.GLOBAL_ACTION_ICON_CLICK单元格右侧的操作 icon 点击时,比如:排序图标
icon 悬停S2Event.GLOBAL_ACTION_ICON_HOVER单元格右侧的操作 icon 悬停时,比如:排序图标
滚动S2Event.GLOBAL_SCROLL表格滚动 (含数值和行头单元格)