logo

G2

  • Chart Gallery
  • Docs
  • Examples
  • Theme
  • Ecosystem
  • Productsantv logo arrow
  • 5.3.3
  • Get Started
  • Introduction
    • What is G2
    • Using in Frontend Frameworks
    • Experimental Spec API
  • Chart 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
      • connector
      • 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
      • quantile
      • quantize
      • sqrt
      • threshold
      • time
      • pow
    • Transform
      • Overview
      • 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
      • Overview
      • fisheye
      • parallel
      • polar
      • theta
      • transpose
      • radial
      • 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
      • legendFilter
      • legendHighlight
      • poptip
      • scrollbarFilter
      • sliderFilter
      • fisheye
    • Composition
      • Overview
      • facetCircle
      • facetRect
      • repeatMatrix
      • spaceFlex
      • spaceLayer
      • timingKeyframe
    • Theme
      • Overview
      • academy
      • classic
      • classicDark
    • Events
    • Color Mapping
  • Chart Component
    • Title
    • Axis
    • Legend
    • Scrollbar
    • Slider
    • Tooltip
    • Data 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)

tree

Previous
sankey
Next
treemap

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

A tree chart (Tree) can decompose things or phenomena into a tree-like structure, also known as a tree diagram or system diagram. In a tree structure, the root node has no predecessor nodes, and each of the remaining nodes has one and only one predecessor node. Leaf nodes have no successor nodes, while each of the remaining nodes can have one or more successor nodes.

Getting Started

tree

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

Options

PropertyDescriptionTypeDefault Value
layoutLayout configurationTreeTransform-
styleConfigure graphics style and label style--
nodeLabelsCustom node data label configurationlabel[][]
linkLabelsCustom link data label configurationlabel[][]

layout

PropertyDescriptionTypeDefault Value
nodeSizeNode size(node: any) => string-
sortBySort method((a, b) => number)(a, b) => b.value - a.value
separationDistance between adjacent nodes(a, b) => number(a, b) => a.parent == b.parent ? 1 : 2

style

Composite graphic marks need to be distinguished by different prefixes for graphic configuration.

  • <label>: Data label prefix, for example: labelText sets the text of the label.
  • <node>: Node configuration prefix, for example: nodeFill sets the fill color of the node.
  • <link>: Link configuration prefix, for example: linkStrokeWidth sets the width of the link.

FAQ

  • How to draw a circular tree chart? You need to specify coordinate: 'polar'