logo

G2

  • 文档
  • API
  • 图表示例
  • 主题
  • 周边生态
  • 所有产品antv logo arrow
  • 5.3.2
  • 快速上手
  • 简介
    • 什么是 G2
    • 在前端框架中使用
    • Spec 和 API
  • 核心概念
    • 图表(Chart)
      • G2 图表组成
      • 如何使用图表
    • 标记(Mark)
      • 概览
      • area
      • box
      • boxplot
      • cell
      • chord
      • density
      • gauge
      • heatmap
      • image
      • interval
      • line
      • lineX
      • lineY
      • link
      • liquid
      • point
      • polygon
      • range
      • rangeX
      • rangeY
      • rect
      • shape
      • text
      • vector
      • wordCloud
    • 视图(View)
    • 数据(Data)
      • 概览
      • custom
      • ema
      • fetch
      • filter
      • fold
      • inline
      • join
      • kde
      • log
      • map
      • pick
      • rename
      • slice
      • sort
      • sortBy
    • 编码(Encode)
    • 比例尺(Scale)
      • 概览
      • band
      • linear
      • log
      • ordinal
      • point
      • pow
      • quantile
      • quantize
      • sqrt
      • threshold
      • time
    • 转换(Transform)
      • 概览
      • bin
      • binX
      • diffY
      • dodgeX
      • flexX
      • group
      • groupColor
      • groupX
      • groupY
      • jitter
      • jitterX
      • jitterY
      • normalizeY
      • pack
      • sample
      • select
      • selectX
      • selectY
      • sortColor
      • sortX
      • sortY
      • stackEnter
      • stackY
      • symmetryY
    • 坐标系(Coordinate)
      • 概览
      • fisheye
      • parallel
      • polar
      • radial
      • theta
      • transpose
      • cartesian3D
      • helix
    • 样式(Style)
    • 动画(Animate)
      • 概览
      • fadeIn
      • fadeOut
      • growInX
      • growInY
      • morphing
      • pathIn
      • scaleInX
      • scaleInY
      • scaleOutX
      • scaleOutY
      • waveIn
      • zoomIn
      • zoomOut
    • 状态(State)
    • 交互(Interaction)
      • 概览
      • brushAxisHighlight
      • brushHighlight
      • brushXHighlight
      • brushYHighlight
      • brushFilter
      • brushXFilter
      • brushYFilter
      • chartIndex
      • elementHighlight
      • elementHighlightByColor
      • elementHighlightByX
      • elementSelect
      • elementSelectByColor
      • elementSelectByX
      • fisheye
      • legendFilter
      • legendHighlight
      • poptip
      • scrollbarFilter
      • sliderFilter
    • 复合(Composition)
      • 概览
      • facetCircle
      • facetRect
      • repeatMatrix
      • spaceFlex
      • spaceLayer
      • timingKeyframe
    • 主题(Theme)
      • 概览
      • academy
      • classic
      • classicDark
    • 事件(Event)
    • 颜色映射(Color)
  • 图表组件
    • 标题(Title)
    • 坐标轴(Axis)
    • 图例(Legend)
    • 滚动条(Scrollbar)
    • 缩略轴(Slider)
    • 提示信息(Tooltip)
    • 数据标签(Label)
  • 进阶主题
    • 关系图(Graph)
      • forceGraph
      • pack
      • sankey
      • tree
      • treemap
    • 地图(Geo)
      • geoPath
      • geoView
    • 3D 图表(3D Chart)
      • 绘制 3D 图表
      • point3D
      • line3D
      • interval3D
      • surface3D
    • 插件扩展(Plugin)
      • renderer
      • rough
      • lottie
    • 按需打包
    • 设置纹理
    • 绘制 3D 图表
    • 服务端渲染(SSR)
    • Spec 函数表达式支持 (5.3.0 支持)
  • 版本特性
    • 新版本特性
    • v4 升级 v5 指南
  • 常见问题 FAQ

什么是 G2

上一篇
快速上手
下一篇
在前端框架中使用

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

G2 是一个简洁的渐进式语法,主要用于制作基于网页的可视化。它提供了一套函数风格式、声明形式的 API 和组件化的编程范式,希望能帮助用户能快速完成报表搭建、数据探索、可视化叙事等多样化的需求。

这篇文章将给大家简单介绍一下 G2 的核心概念:

  • 标记(Mark):绘制数据驱动的图形
  • 转换(Transform):派生数据
  • 比例尺(Scale):将抽象的数据映射为视觉数据
  • 坐标系(Coordinate):对空间通道应用点变换
  • 视图复合(Composition):管理和增强视图
  • 动画(Animation):数据驱动的动画和连续的形变动画
  • 交互(Interaction): 操作视图并且展现详细信息

"Talk is cheap, show me the code",那么接下来看看基于下面这个简单的数据集,G2 能做出什么可视化效果。

table({
url: 'https://gw.alipayobjects.com/os/antvdemo/assets/data/scatter.json',
});

提示

在 G2 官网的文档中,特定代码块会挂载其返回的 DOM,并在网页中展示。

(() => {
const chart = new G2.Chart();
// ...
return chart.getContainer(); // 挂载图表的容器
})();

这是在 G2 官网特定运行环境的语法,在实际项目中使用 G2 请参考快速上手。

标记(Mark)

标记是 G2 中最小的视觉单元,G2 中的所有图表都是由不同标记构成的。

(() => {
const chart = new G2.Chart();
chart
.point()
.data({
type: 'fetch',
value:
'https://gw.alipayobjects.com/os/antvdemo/assets/data/scatter.json',
})
.encode('x', 'weight')
.encode('y', 'height')
.encode('color', 'gender');
chart.render();
return chart.getContainer();
})();

转换(Transform)

转换会改变数据和标记的展现形式,多用于数据分析。

(() => {
const chart = new G2.Chart();
chart
.rect()
.data({
type: 'fetch',
value:
'https://gw.alipayobjects.com/os/antvdemo/assets/data/scatter.json',
})
.encode('x', 'height')
.encode('color', 'gender')
.transform({ type: 'binX', y: 'count' })
.transform({ type: 'stackY' })
.style('insetLeft', 1);
chart.render();
return chart.getContainer();
})();

比例尺(Scale)

比例尺用于控制标记的视觉样式。

(() => {
const chart = new G2.Chart();
chart
.rect()
.data({
type: 'fetch',
value:
'https://gw.alipayobjects.com/os/antvdemo/assets/data/scatter.json',
})
.encode('x', 'height')
.encode('color', 'gender')
.transform({ type: 'binX', y: 'count' })
.transform({ type: 'stackY' })
.scale('color', { range: ['steelblue', 'orange'] })
.scale('y', { nice: true })
.style('insetLeft', 1);
chart.render();
return chart.getContainer();
})();

坐标系(Coordinate)

坐标系会改变图表的展示形式。

(() => {
const chart = new G2.Chart();
chart
.rect()
.data({
type: 'fetch',
value:
'https://gw.alipayobjects.com/os/antvdemo/assets/data/scatter.json',
})
.encode('x', 'height')
.encode('color', 'gender')
.transform({ type: 'binX', y: 'count' })
.transform({ type: 'stackY' })
.scale('color', { range: ['steelblue', 'orange'] })
.scale('y', { type: 'sqrt', nice: true })
.coordinate({ type: 'polar' })
.axis('y', { title: false })
.style('insetLeft', 1);
chart.render();
return chart.getContainer();
})();

视图复合(Composition)

视图复合用于制作多视图图表。

(() => {
const chart = new G2.Chart({
paddingLeft: 60,
});
const facet = chart
.facetRect()
.data({
type: 'fetch',
value:
'https://gw.alipayobjects.com/os/antvdemo/assets/data/scatter.json',
})
.encode('y', 'gender');
facet
.rect()
.encode('x', 'height')
.encode('color', 'gender')
.transform({ type: 'binX', y: 'count' })
.transform({ type: 'stackY' })
.scale('y', { nice: true })
.attr('frame', false)
.style('insetLeft', 1);
chart.render();
return chart.getContainer();
})();

动画(Animation)

动画支持分组动画和关键帧动画。可以点击左边的运行按钮看效果。

(() => {
const chart = new G2.Chart();
chart
.rect()
.data({
type: 'fetch',
value:
'https://gw.alipayobjects.com/os/antvdemo/assets/data/scatter.json',
})
.encode('x', 'height')
.encode('color', 'gender')
.encode('enterDuration', 1000)
.transform({ type: 'stackEnter', groupBy: ['color'] })
.transform({ type: 'binX', y: 'count' })
.transform({ type: 'stackY' })
.style('insetLeft', 1);
chart.render();
return chart.getContainer();
})();

(async () => {
const data = await fetch(
'https://gw.alipayobjects.com/os/antvdemo/assets/data/scatter.json',
).then((res) => res.json());
const chart = new G2.Chart();
const keyframe = chart
.timingKeyframe()
.attr('direction', 'alternate')
.attr('iterationCount', 4);
keyframe
.interval()
.attr('padding', 'auto')
.data(data)
.encode('x', 'gender')
.encode('color', 'gender')
.encode('key', 'gender')
.transform({ type: 'groupX', y: 'count' });
keyframe
.point()
.attr('padding', 'auto')
.data(data)
.encode('x', 'weight')
.encode('y', 'height')
.encode('color', 'gender')
.encode('groupKey', 'gender')
.encode('shape', 'point');
chart.render();
return chart.getContainer();
})();

交互(Interaction)

交互可以按需探索数据。

(() => {
const chart = new G2.Chart();
chart
.point()
.data({
type: 'fetch',
value:
'https://gw.alipayobjects.com/os/antvdemo/assets/data/scatter.json',
})
.encode('x', 'weight')
.encode('y', 'height')
.encode('color', 'gender')
.encode('shape', 'point')
.style({
fillOpacity: 0.7,
transform: 'scale(1, 1)',
transformOrigin: 'center center',
})
.state('inactive', {
fill: 'black',
fillOpacity: 0.5,
transform: 'scale(0.5, 0.5)',
})
.interaction('brushXHighlight', true);
chart.render();
return chart.getContainer();
})();

更多能力

因为 G2 的标记是可以组合的,同时提供了复合标记的机制去扩展 G2,所以你基本上可以快速绘制任意的可视化。在案例页面你可以获得更多灵感,也可以通过文档全面了解 G2 的能力。