logo

G2

  • 图表介绍
  • 文档
  • 图表示例
  • 主题
  • 周边生态
  • 所有产品antv logo arrow
  • 5.3.3
  • 快速上手
  • 简介
    • 什么是 G2
    • 在前端框架中使用
    • Spec 和 API
  • 图表 API
  • 核心概念
    • 图表(Chart)
      • G2 图表组成
      • 如何使用图表
    • 标记(Mark)
      • 概览
      • 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
      • connector
      • 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
      • quantile
      • quantize
      • sqrt
      • threshold
      • time
      • pow
    • 转换(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
      • theta
      • transpose
      • radial
      • 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
      • a11y
    • 按需打包
    • 设置纹理
    • 服务端渲染(SSR)
    • Spec 函数表达式支持 (5.3.0 支持)
  • 版本特性
    • 新版本特性
    • v4 升级 v5 指南
  • 常见问题 FAQ

tree

上一篇
sankey
下一篇
treemap

资源

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

树图 (Tree) 能将事物或现象分解成树枝状,又称树型图或系统图。在树形结构中,树根结点没有前驱结点,其余每个结点有且只有一个前驱结点。叶子结点没有后续结点,其余每个结点的后续节点数可以是一个也可以是多个。

开始使用

import { Chart } from '@antv/g2';
const chart = new Chart({ container: 'container' });
chart.options({
type: 'tree',
width: 800,
height: 1500,
layout: { sortBy: (a, b) => a.value - b.value },
data: {
type: 'fetch',
value: 'https://assets.antv.antgroup.com/g2/flare.json',
},
coordinate: { transform: [{ type: 'transpose' }] },
style: {
nodeFill: (d) => (d.height === 0 ? '#999' : '#000'),
linkStroke: '#999',
labelText: (d) => d.data.name || '-',
labelFontSize: (d) => (d.height === 0 ? 7 : 12),
labelTextAlign: (d) => (d.height === 0 ? 'start' : 'end'),
labelPosition: (d) => (d.height !== 0 ? 'left' : 'right'),
labelDx: (d) => (d.height === 0 ? 5 : -5),
labelBackground: true,
labelBackgroundFill: '#fff',
},
});
chart.render();

数据格式

树图支持多种数据配置方式:

1. 远程数据 (fetch)

通过 type: 'fetch' 从远程获取数据,支持 JSON、CSV 等格式:

chart.tree().data({
type: 'fetch',
value: 'https://assets.antv.antgroup.com/g2/flare.json',
});

2. 内联数据 (inline)

显式指定 inline 类型

import { Chart } from '@antv/g2';
const chart = new Chart({ container: 'container' });
chart.options({
type: 'tree',
data: {
type: 'inline',
value: {
name: 'root',
children: [
{
name: 'branch1',
value: 100,
children: [
{ name: 'leaf1', value: 50 },
{ name: 'leaf2', value: 30 },
],
},
{
name: 'branch2',
value: 80,
children: [
{ name: 'leaf3', value: 40 },
{ name: 'leaf4', value: 40 },
],
},
],
},
},
});
chart.render();

简写形式(推荐)

由于 G2 默认数据类型是 inline,可以直接传入数据:

// 直接传入层级数据对象
chart.tree().data({
value: {
name: 'root',
children: [
{
name: 'branch1',
value: 100,
children: [
{ name: 'leaf1', value: 50 },
{ name: 'leaf2', value: 30 },
],
},
],
},
});
// 或者传入扁平数据数组(需要配置 layout.path)
const flatData = [
{ name: 'root', value: 180 },
{ name: 'root/branch1', value: 100 },
{ name: 'root/branch1/leaf1', value: 50 },
{ name: 'root/branch1/leaf2', value: 30 },
{ name: 'root/branch2', value: 80 },
{ name: 'root/branch2/leaf3', value: 40 },
{ name: 'root/branch2/leaf4', value: 40 },
];
chart
.tree()
.data({ value: flatData })
.layout({
path: (d) => d.name, // 指定路径字段
});

数据格式说明

树图支持两种数据结构:

  1. 层级结构数据:已经是树形结构的 JSON 对象,每个节点包含 children 数组
  2. 扁平数据:包含路径信息的数组,需要通过 layout.path 配置来构建层级关系

层级结构数据示例:

{
"name": "root",
"value": 180,
"children": [
{
"name": "branch1",
"value": 100,
"children": [
{ "name": "leaf1", "value": 50 },
{ "name": "leaf2", "value": 30 }
]
}
]
}

扁平数据示例:

[
{ "name": "root", "value": 180 },
{ "name": "root/branch1", "value": 100 },
{ "name": "root/branch1/leaf1", "value": 50 }
]

选项

属性描述类型默认值
layout布局配置TreeTransform-
style配置图形样式和标签样式--
nodeLabels自定义节点数据标签的配置label[][]
linkLabels自定义连接线数据标签的配置label[][]

layout

属性描述类型默认值
nodeSize节点大小(node: any) => string-
sortBy排序方式((a, b) => number)(a, b) => b.value - a.value
separation相邻节点间距(a, b) => number(a, b) => a.parent == b.parent ? 1 : 2
path路径字段配置(d: any) => string-

注意:当使用扁平数据时,必须配置 layout.path 来指定如何从数据中提取层级路径信息。

style

复合图形标记需要通过不同的前缀来区分图形的配置。

  • <label>: 数据标签的前缀,例如:labelText 设置标签的 text 文本。
  • <node>: 节点配置的前缀,例如:nodeFill 设置节点的填充颜色。
  • <link>: 连接线配置的前缀,例如:linkStrokeWidth 设置连接线的宽度。

FAQ

  • 如何绘制圆形树图? 需要指定 coordinate: { type: 'polar' }

import { Chart } from '@antv/g2';
const chart = new Chart({ container: 'container' });
chart.options({
type: 'tree',
layout: { sortBy: (a, b) => a.value - b.value },
data: {
type: 'fetch',
value: 'https://assets.antv.antgroup.com/g2/flare.json',
},
coordinate: { type: 'polar' },
style: {
nodeFill: (d) => (d.height === 0 ? '#999' : '#000'),
linkStroke: '#999',
labelText: (d) => d.data.name || '-',
labelFontSize: (d) => (d.height === 0 ? 7 : 12),
labelTextAlign: (d) => (d.height === 0 ? 'start' : 'end'),
labelPosition: (d) => (d.height !== 0 ? 'left' : 'right'),
labelDx: (d) => (d.height === 0 ? 5 : -5),
labelBackground: true,
labelBackgroundFill: '#fff',
},
});
chart.render();