logo

Ant Design Charts

  • Manual
  • Components
  • Examples
  • Options
  • Productsantv logo arrow
  • 2.4.0
  • Component Overview
  • Statistical Charts
    • Chart overview
    • Line
    • Column
    • Bar
    • Area
    • Pie
    • DualAxes
    • Scatter
    • WordCloud
    • Funnel
    • Heatmap
    • Histogram
    • Liquid
    • BidirectionalBar
    • Box
    • Bullet
    • CirclePacking
    • Gauge
    • Radar
    • Rose
    • Sankey
    • Stock
    • Sunburst
    • Treemap
    • Venn
    • Tiny
    • Violin
    • Waterfall
    • RadialBar
  • Relation Graph Components
    • Overview
    • MindMap
    • Fishbone
    • IndentedTree
    • Dendrogram
    • OrganizationChart
    • FlowGraph
    • FlowDirectionGraph
    • NetworkGraph
    • FAQ

Heatmap

Previous
Funnel
Next
Histogram

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

简介

热力图(Heatmap)是一种通过颜色强度映射二维数据密度或数值大小的可视化图表,擅长揭示数据分布规律、聚类特征及异常点。

典型应用包括:

  • 相关性分析:例如,用于展示变量之间的相关性矩阵,通过颜色深浅快速识别强相关或弱相关的变量。
  • 密度分析:展示二维数据的密度分布,常用于观察热点区域,例如在地理空间数据中用于分析人群聚集分布。
  • 时间序列与类别分析:将时间(如小时、天、周)与类别数据结合,用于分析时序模式或分类分布。

代码演示

更多示例详见热力图

基础用法

形状修改

自定义形状

密度热力图

配置项

概览

配置项说明类型默认值
data数据Array[]
xField横轴字段string-
yField纵轴字段string | string[]-
shapeFieldpoint | cell | heatmapstring(可选)-
sizeField尺寸大小映射字段string(可选)-
colorField颜色映射通道,详见colorstring(可选)-
title用于指定图表的标题内容,详见标题object(可选)-
axis用于建立数据与视觉位置的映射关系,详见坐标轴object(可选)-
legend图表的辅助元素,使用颜色、大小、形状区分不同的数据类型,用于图表中数据的筛选,详见图例object(可选)-
scrollbar用于过滤数据,可以和 x 或者 y 通道绑定,详见滚动条object(可选)-
slider用于过滤数据,让用户在数据量较大的情况下一次只用关注局部的数据,是一种辅助看数据的组件,详见滑块object(可选)-
label数据标签是给图表添加标注的手段之一,详见标签object(可选)-
tooltip用于动态展示数据点的详细信息,详见提示object(可选)-
style视觉样式,配置项详见绘图属性object(可选)-
theme用于控制图表的整体外观,包括颜色、字体、边距等视觉属性,详见主题string | object(可选)light
onReady图表加载回调,用于后续的事件事件绑定Function(可选)-
scale将抽象数据映射为视觉数据,详见比例尺object(可选)-
animate动画作为可视化的重要组成部分,能显著提高数据可视化的表现力,详见动画object(可选)-
interaction提供了按需探索数据的能力,详见交互object(可选)-
state实现交互反馈、高亮、选中等效果,详见状态,不同交互下图表样式object(可选)-
annotations视图好比一个画板,Heatmap 组件默认在其上绘制了一个热力图,我们可以通过 annotations 在上面叠加更多的图层,详见标注Array(可选)-

Style

视觉样式,更多配置项详见绘图属性

属性描述类型默认值必选
gradient图形对应的渐变色配置string | Array<[number, string]>-
opacity热力图的透明度 ,如果设置,则会覆盖 maxOpacity, minOpacity 配置,范围 0 ~ 1number0.6
maxOpacity热力图像素点透明度最大值,在 opacity = 0 时候生效,范围 0 ~ 1number1
minOpacity热力图像素点透明度最小值,在 opacity = 0 时候生效,范围 0 ~ 1number0
blur热力图的模糊因子,范围 0 ~ 1,越大图形约平滑number0.85
useGradientOpacity图形的填充色booleanfalse
const gradient = [
[0.25, 'rgb(0,0,255)'],
[0.55, 'rgb(0,255,0)'],
[0.85, 'yellow'],
[1.0, 'rgb(255,0,0)'],
];
const gradient =
'0.25:rgb(0,0,255) 0.55:rgb(0,255,0) 0.85:yellow 1.0:rgb(255,0,0)';

事件

详见选项-事件。

方法

详见图表概览-图表方法。