logo

Ant Design Charts

  • 教程
  • 选项
  • 图表示例
  • 所有产品antv logo arrow
  • 2.0.0
  • 📈 图表分类
  • 统计图表
    • 图表组成
    • 图表组件 - Component
      • 标题(Title)
      • 坐标轴(Axis)
      • 图例(Legend)
      • 滚动条(Scrollbar)
      • 缩略轴(Slider)
      • 提示信息(Tooltip)
      • 数据标签(Label)
    • 核心概念 - Core
      • 视图(View)
      • 数据(Data)
        • 概览
        • custom
        • ema
        • fetch
        • filter
        • fold
        • inline
        • join
        • kde
        • log
        • map
        • pick
        • rename
        • slice
        • sort
        • sortBy
      • 比例尺(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
      • 样式(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)
    • 专有配置 - Specal Plot
      • Area 面积图
      • Bar 条形图
      • CirclePacking 捆绑图
      • DualAxes 双轴图
      • Gauge 仪表盘
      • Line 折线图
      • Rose 玫瑰图
      • Sankey 桑基图
      • Scatter 散点图
      • Sunburst 旭日图
      • Treemap 矩阵树图
      • Venn 韦恩图
      • WordCloud 词云图
      • Column 柱状图
      • Pie 饼图
      • BidirectionalBar 对称条形图
      • Box 箱线图
      • Bullet 子弹图
      • Funnel 漏斗图
      • Heatmap 热力图
      • Histogram 直方图
      • Liquid 水波图
      • Radar 雷达图
      • Stock 股票图
      • Tiny 迷你图
      • Violin 小提琴图
      • Waterfall 瀑布图
      • RadialBar 玉珏图
  • 关系图组件
    • 总览
    • MindMap 思维导图
    • Fishbone 鱼骨图
    • IndentedTree 缩进树图
    • Dendrogram 生态树图
    • OrganizationChart 组织结构图
    • FlowGraph 流程图
    • FlowDirectionGraph 流向图
    • NetworkGraph 网络图
    • FAQ

标题(Title)

上一篇
图表组成
下一篇
坐标轴(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...

概述

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

使用方式

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

({
title: false; // 隐藏图表标题
})

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

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

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

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

开始使用

{
"marginTop": 40,
"title": {
"align": "center",
"size": 28,
"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
}
}

标题 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,分别代表着居左对齐、居中对齐、居右对齐。

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