logo

G2

  • Docs
  • Chart Introduction
  • API
  • Examples
  • Theme
  • Ecosystem
  • Productsantv logo arrow
  • 5.3.3
  • Get Started
  • Introduction
    • What is G2
    • Use In Framework
    • Experimental Spec API
  • Core Concepts
    • Chart
      • Components of G2 Charts
      • How to Use Charts
    • Mark
      • overview
      • area
      • box
      • boxplot
      • cell
      • chord
      • density
      • gauge
      • heatmap
      • image
      • interval
      • line
      • lineX
      • lineY
      • link
      • liquid
      • sunburst
      • point
      • polygon
      • range
      • rangeX
      • rangeY
      • rect
      • shape
      • text
      • vector
      • wordCloud
    • View
    • Data
      • overview
      • custom
      • ema
      • fetch
      • filter
      • fold
      • inline
      • join
      • kde
      • log
      • map
      • pick
      • rename
      • slice
      • sort
      • sortBy
    • Encode
    • Scale
      • overview
      • band
      • linear
      • log
      • ordinal
      • point
      • pow
      • quantile
      • quantize
      • sqrt
      • threshold
      • time
    • Transform
      • overview
      • bin
      • binX
      • diffY
      • dodgeX
      • flexX
      • group
      • groupColor
      • groupX
      • groupY
      • jitter
      • jitterX
      • jitterY
      • normalizeY
      • pack
      • sample
      • select
      • selectX
      • selectX
      • sortColor
      • sortX
      • sortY
      • stackEnter
      • stackY
      • symmetryY
    • Coordinate
      • overview
      • fisheye
      • parallel
      • polar
      • radial
      • theta
      • transpose
      • cartesian3D
      • helix
    • Style
    • Animate
      • overview
      • fadeIn
      • fadeOut
      • growInX
      • growInY
      • morphing
      • pathIn
      • scaleInX
      • scaleInY
      • scaleOutX
      • scaleOutY
      • waveIn
      • zoomIn
      • zoomOut
    • State
    • Interaction
      • Overview
      • brushAxisHighlight
      • brushHighlight
      • brushXHighlight
      • brushYHighlight
      • brushFilter
      • brushXFilter
      • brushYFilter
      • chartIndex
      • elementHighlight
      • elementHighlightByColor
      • elementHighlightByX
      • elementSelect
      • elementSelectByColor
      • elementSelectByX
      • fisheye
      • legendFilter
      • legendHighlight
      • poptip
      • scrollbarFilter
      • sliderFilter
    • Composition
      • overview
      • facetCircle
      • facetRect
      • repeatMatrix
      • spaceFlex
      • spaceLayer
      • timingKeyframe
    • Theme
      • overview
      • Academy
      • classic
      • classicDark
    • event
    • Color
  • Chart API
  • Chart Component
    • 标题(Title)
    • Axis
    • Legend
    • Scrollbar
    • Slider
    • Tooltip
    • Label
  • Extra Topics
    • Graph
      • forceGraph
      • pack
      • sankey
      • tree
      • treemap
    • Geo
      • geoPath
      • geoView
    • 3D
      • Draw 3D Chart
      • point3D
      • line3D
      • interval3D
      • surface3D
    • Plugin
      • renderer
      • rough
      • lottie
      • a11y
    • Package on demand
    • Set pattern
    • Server-side rendering(SSR)
    • Spec Function Expression Support (Available in 5.3.0)
  • Whats New
    • New Version Features
    • Migration from v4 to v5
  • Frequently Asked Questions (FAQ)

event

Previous
classicDark
Next
Color

Resources

Ant Design
Galacea Effects
Umi-React Application Framework
Dumi-Component doc generator
ahooks-React Hooks Library

Community

Ant Financial Experience Tech
seeconfSEE Conf-Experience Tech Conference

Help

GitHub
StackOverflow

more productsMore Productions

Ant DesignAnt Design-Enterprise UI design language
yuqueYuque-Knowledge creation and Sharing tool
EggEgg-Enterprise-class Node development framework
kitchenKitchen-Sketch Tool set
GalaceanGalacean-互动图形解决方案
xtechLiven Experience technology
© Copyright 2025 Ant Group Co., Ltd..备案号:京ICP备15032932号-38

Loading...

G2 exposes some events to get the chart life cycle and interaction information. G2 exports a ChartEvent type, used to define the type of event.

click event
import { Chart, ChartEvent } from '@antv/g2';
const chart = new Chart({
container,
canvas,
});
chart.data([
{ genre: 'Sports', sold: 275 },
{ genre: 'Strategy', sold: 115 },
{ genre: 'Action', sold: 120 },
{ genre: 'Shooter', sold: 350 },
{ genre: 'Other', sold: 150 },
]);
chart
.interval()
.encode('x', 'genre')
.encode('y', 'sold')
.encode('color', 'genre')
.axis({ x: { animate: false }, y: { animate: false } });
chart.on('interval:click', (e) => {
console.log(e.data.data); // Display clicked data
});
chart.on('element:click', (e) => {
console.log(e.data.data); // Display clicked data
});
chart.render();

Life cycle events

If you want to get the life cycle information of the chart, you can do the following:

chart.on(ChartEvent.AFTER_RENDER, (ev) => {
console.log(ev);
});

G2 currently provides the following lifecycle events:

Event nameExplanation
ChartEvent.BEFORE_RENDERBefore rendering
ChartEvent.BEFORE_PAINTBefore drawing
ChartEvent.AFTER_PAINTAfter drawing
ChartEvent.AFTER_RENDERAfter rendering
ChartEvent.BEFORE_CHANGE_DATABefore changing data
ChartEvent.AFTER_CHANGE_DATAAfter changing data
ChartEvent.BEFORE_CLEARBefore cleaning the canvas
ChartEvent.AFTER_CLEARAfter cleaning the canvas
ChartEvent.BEFORE_DESTROYBefore destroying the canvas
ChartEvent.AFTER_DESTROYAfter destroying the canvas
ChartEvent.BEFORE_CHANGE_SIZEBefore changing canvas size
ChartEvent.AFTER_CHANGE_SIZEAfter changing canvas size
  • Before rendering: Refers to G2 starting to process data, perform layout, drawing graphics and other operations.
  • Before drawing: Refers to the completion of data processing, layout, graphics drawing and other operations, but has not yet been drawn.
  • After drawing: Refers to G2 completing all drawing operations, but animation may exist. After the animation ends, the chart is truly rendered.
  • After rendering: Refers to G2 completing all drawing operations, including animation.
  • After cleaning the canvas: The chart in the container has been cleaned up, but the G2 instance still exists and can continue to be used.
  • After destroying the canvas: The G2 instance has been destroyed and can no longer be used.

Interaction events

If you want to get the interactive information of the chart, you can do the following:

  • Monitor the global element event
chart.on(`element:${ChartEvent.EventType}`, (ev) => {
console.log(ev);
});
  • Monitor specified element event
chart.on(`${markType}:${ChartEvent.EventType}`, (ev) => {
console.log(ev);
});
// For example, listen to the click event of the bar in the bar chart
chart.on(`interval:${ChartEvent.CLICK}`, (ev) => {
console.log(ev);
});
  • Listen to plot area events
chart.on('plot:click', (event) => console.log(event));
  • Listen to global component events
chart.on('component:click', (event) => console.log(event));
  • Listen to global label events
chart.on('label:click', (event) => console.log(event));

Click event

Event nameExplanationCallback parameters
ChartEvent.CLICKClickEvent
ChartEvent.DBLCLICKDouble clickEvent

Pointer event

Event nameExplanationCallback parameters
ChartEvent.POINTER_TAPEvent
ChartEvent.POINTER_DOWNWhen the pointer is pressedEvent
ChartEvent.POINTER_UPWhen the pointer is releasedEvent
ChartEvent.POINTER_OVERWhen the pointer enters the target elementEvent
ChartEvent.POINTER_OUTWhen the pointer leaves the target elementEvent
ChartEvent.POINTER_MOVEWhen the pointer changes coordinatesEvent
ChartEvent.POINTER_ENTERWhen the pointer enters the target element or its child elementsEvent
ChartEvent.POINTER_LEAVEWhen the pointer leaves the target element or its child elementsEvent
ChartEvent.POINTER_UPOUTSIDEEvent

Drag event

If you want to listen to drag events, you need to set the draggable and droppable properties.

chart.interval().style('draggable', true).style('droppable', true);
Event nameExplanationCallback parameters
ChartEvent.DRAG_STARTWhen starting to dragEvent
ChartEvent.DRAGDuring draggingEvent
ChartEvent.DRAG_ENDWhen dragging is completeEvent
ChartEvent.DRAG_ENTERWhen the element is dragged into the target elementEvent
ChartEvent.DRAG_LEAVEWhen the element is dragged away from the target elementEvent
ChartEvent.DRAG_OVERWhen the element is dragged and hovered within the target elementEvent
ChartEvent.DROPWhen the element is placed inside the target elementEvent

Typical cases

For details, see Interaction - Events Examples