logo

G2

  • 文档
  • 图表介绍
  • API
  • 图表示例
  • 主题
  • 周边生态
  • 所有产品antv logo arrow
  • 5.3.3
  • 快速上手
  • 简介
    • 什么是 G2
    • 在前端框架中使用
    • Spec 和 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
      • 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)
  • 图表 API
  • 图表组件
    • 标题(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

标题(Title)

上一篇
图表 API
下一篇
坐标轴(Axis)

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 中标题(Title) 用于指定图表的标题内容,可以用于一句话展示图表的概要信息。图表的标题是比较常用的组件,分成为主标题和副标题两部分组成,均使用一个文本来展示,可以通过调整文本的样式来定制图表标题的样式。

使用方式

第一种,传入 boolean 设置是否显示图表标题,图表标题默认为隐藏状态。

({
type: 'interval',
title: false; // 隐藏图表标题
})

第二种,传入 titleOption 对图标表进行整体配置。

({
type: 'interval',
title: {
title: 'hello', // 主标题的文本新秀丽
subtitle: 'world', // 副标题的文本新秀丽
},
});

标题也可以在 View 层级配置:

({
type: 'view',
title: {
title: 'hello',
subtitle: 'world',
},
});

开始使用

import { Chart } from '@antv/g2';
const chart = new Chart({
container: 'container',
});
chart.options({
type: 'interval',
marginTop: 40,
data: {
type: 'fetch',
value:
'https://gw.alipayobjects.com/os/bmw-prod/fb9db6b7-23a5-4c23-bbef-c54a55fee580.csv',
},
encode: {
x: 'letter',
y: 'frequency',
},
title: {
align: 'center', // 图表标题的对齐方式
size: 28, // 图表标题的高度,默认为 36
spacing: 4, // 主标题和副标题之间的间距
// 标题
title: "我是一个标题 I'am a title", // 图表标题的文本
titleFontSize: 28, // 图表主标题的字体大小
titleFontFamily: 'sans-serif', // 图表主标题的字体
titleFontWeight: 600, // 图表主标题的字体粗细
titleFill: '#fff', // 图表主标题的文字颜色
titleFillOpacity: 1, // 图表主标题的文字透明度
titleStroke: '#000', // 图表主标题的文字描边颜色
titleLineWidth: 2, // 图表主标题的文字描边线宽
titleStrokeOpacity: 1, // 图表主标题的文字描边透明度
// 副标题
subtitle: "我是一个副标题 I'am a subtitle", // 图表副标题的文本
subtitleFontSize: 16, // 图表副标题的字体大小
subtitleFontFamily: 'Arial', // 图表副标题的字体
subtitleFontWeight: 300, // 图表副标题的字体粗细
subtitleFill: '#2989FF', // 图表副标题的文字颜色
subtitleFillOpacity: 1, // 图表副标题的文字透明度
subtitleStroke: '#000', // 图表副标题的文字描边颜色
subtitleLineWidth: 1, // 图表副标题的文字描边线宽
subtitleStrokeOpacity: 0.5, // 图表副标题的文字描边透明度
},
});
chart.render();

标题 title 的设置,最简单的设置方式,就是直接指定一个字符串作为标题,这个时候使用默认的样式和位置。当然也可以使用完整的配置项去做一些灵活的自定义。

配置项

属性描述类型默认值
size图表标题的高度number36
align图表标题的对齐方式left | center | rightleft
spacing图表主标题、副标题之间的上下间距number2
title图表标题的配置项title详见 title
subtitle图表副标题的配置项subtitle详见 subtitle

size

number optional

用于配置图表标题的空间高度大小,默认为 36px,如果配置过小,可能导致标题和图表图形之间重叠。

align

string optional

用于配置图表标题的的左右对齐方式,默认为 left,可以选择使用 left,center,right,分别代表着居左对齐、居中对齐、居右对齐。

尝试一下:

(() => {
const chart = new G2.Chart({ width: 480, height: 160 });
const alignList = ['center', 'right', 'left'];
const alignMap = alignList.map((p) => {
return {
label: p,
value: p,
};
});
const data = [
264, 417, 438, 887, 309, 397, 550, 575, 563, 430, 525, 592, 492, 467, 513,
546, 983, 340, 539, 243, 226, 192,
];
chart.options({
data,
type: 'interval',
encode: {
x: (_, idx) => idx,
y: (d) => d,
},
title: {
align: 'center',
title: 'This is a chart title.',
subtitle: 'Displayed are sampled values.',
},
axis: false,
});
const handleSetAlign = (align) => {
chart.title({ align });
chart.render(); // 重新渲染图表
};
const selectorContainer = document.createElement('div');
selectorContainer.textContent = '选择标题对齐方式 ';
const selector = document.createElement('select');
selector.innerHTML = alignMap.map(
(align, index) =>
`<option value="${align.value}" ${index === 0 ? 'selected' : ''}>${
align.label
}</option>`,
);
selector.onchange = (e) => {
handleSetAlign(e.target.value);
};
selectorContainer.appendChild(selector);
const node = chart.getContainer();
node.insertBefore(selectorContainer, node.childNodes[0]);
chart.render();
return node;
})();

spacing

number optional

用于配置图表主标题和副标题之间的间距,默认为 2px,合适的间距,可以让图表看起来整体更协调。

title

图表的标题,具体来说是主标题,可以用以下的配置来定制标题的各种样式。

属性描述类型默认值
title图表标题文字内容number | (datum, index, data) => number-
titleFontSize图表标题字体大小number | (datum, index, data) => number14
titleFontFamily图表标题字体类型string | (datum, index, data) => stringsans-serif
titleFontWeight图表标题字体粗细string | (datum, index, data) => stringnormal
titleTextAlign图表标题水平对齐string | (datum, index, data) => stringcenter
titleTextBaseline图表标题垂直基线string | (datum, index, data) => stringmiddle
titleFill图表标题填充颜色string | (datum, index, data) => string#000
titleFillOpacity图表标题填充透明度number | (datum, index, data) => number1
titleStroke图表标题描边颜色string | (datum, index, data) => stringtransparent
titleStrokeOpacity图表标题描边透明度number | (datum, index, data) => number1
titleLineHeight图表标题行高number | (datum, index, data) => number14
titleLineWidth图表标题描边宽度number | (datum, index, data) => number0
titleLineDash图表标题虚线样式number[] | (datum, index, data) => number[][]
titleOpacity图表标题整体透明度number | (datum, index, data) => number1
titleShadowColor图表标题阴影颜色string | (datum, index, data) => stringtransparent
titleShadowBlur图表标题阴影模糊度number | (datum, index, data) => number0
titleShadowOffsetX图表标题阴影 X 偏移number | (datum, index, data) => number0
titleShadowOffsetY图表标题阴影 Y 偏移number | (datum, index, data) => number0
titleCursor图表标题鼠标样式string | (datum, index, data) => stringdefault

subtitle

图表的副标题,可以用以下的配置来定制副标题的各种样式。

属性描述类型默认值
subtitle图表副标题文本number | (datum, index, data) => number12
subtitleFontSize图表副标题字体大小number | (datum, index, data) => number12
subtitleFontFamily图表副标题字体类型string | (datum, index, data) => stringsans-serif
subtitleFontWeight图表副标题字体粗细string | (datum, index, data) => stringnormal
subtitleTextAlign图表副标题水平对齐string | (datum, index, data) => stringcenter
subtitleTextBaseline图表副标题垂直基线string | (datum, index, data) => stringmiddle
subtitleFill图表副标题填充颜色string | (datum, index, data) => string#666
subtitleFillOpacity图表副标题填充透明度number | (datum, index, data) => number1
subtitleStroke图表副标题描边颜色string | (datum, index, data) => stringtransparent
subtitleStrokeOpacity图表副标题描边透明度number | (datum, index, data) => number1
subtitleLineHeight图表副标题行高number | (datum, index, data) => number12
subtitleLineWidth图表副标题描边宽度number | (datum, index, data) => number0
subtitleLineDash图表副标题虚线样式number[] | (datum, index, data) => number[][]
subtitleOpacity图表副标题整体透明度number | (datum, index, data) => number1
subtitleShadowColor图表副标题阴影颜色string | (datum, index, data) => stringtransparent
subtitleShadowBlur图表副标题阴影模糊度number | (datum, index, data) => number0
subtitleShadowOffsetX图表副标题阴影 X 偏移number | (datum, index, data) => number0
subtitleShadowOffsetY图表副标题阴影 Y 偏移number | (datum, index, data) => number0
subtitleCursor图表副标题鼠标样式string | (datum, index, data) => stringdefault

尝试一下: