Radar - 雷达图
|
|
别名 蛛网图 |
|
定义 |
|
|
视觉通道 |
|
|
分析目的 |
|
|
数据准备 1 个「数值」字段 |
快速上手
import { Radar } from '@antv/g2plot';
const data = [
{
item: 'Design',
score: 70,
},
{
item: 'Development',
score: 60,
},
{
item: 'Marketing',
score: 60,
},
{
item: 'Users',
score: 40,
},
{
item: 'Test',
score: 60,
},
{
item: 'Language',
score: 70,
},
{
item: 'Technology',
score: 50,
},
{
item: 'Support',
score: 30,
},
{
item: 'Sales',
score: 60,
},
{
item: 'UX',
score: 50,
},
];
const radarPlot = new Radar(document.getElementById('container'), {
data,
angleField: 'item',
radiusField: 'score',
radiusAxis: {
gridType: 'arc',
gridAlternateColor: 'rgba(0, 0, 0, 0.04)',
},
});
radarPlot.render();配置属性
图表容器
width
可选, number
功能描述： 设置图表宽度。
默认配置： 400
height
可选, number
功能描述： 设置图表高度。
默认配置： 400
forceFit
可选, boolean
功能描述： 图表是否自适应容器宽高。当 forceFit 设置为true时，width 和 height 的设置将失效。
默认配置： true
pixelRatio
可选, number
功能描述： 设置图表渲染的像素比
默认配置： 2
renderer
可选, string
功能描述: 设置图表渲染方式为 canvas 或 svg
默认配置： canvas
数据映射
data 📌
必选, array object
功能描述： 设置图表数据源
默认配置： 无
数据源为对象集合，例如：[{ time: '1991'，value: 20 }, { time: '1992'，value: 20 }]。
meta
可选, object
功能描述： 全局化配置图表数据元信息，以字段为单位进行配置。在 meta 上的配置将同时影响所有组件的文本信息。
默认配置： 无
| 细分配置项名称 | 类型 | 功能描述 |
|---|---|---|
| alias | string | 字段的别名 |
| formatter | function | callback方法，对该字段所有值进行格式化处理 |
| values | string[] | 枚举该字段下所有值 |
| range | number[] | 字段的数据映射区间，默认为[0,1] |
const data = [
{ country: 'Asia', year: '1750', value: 502,},
{ country: 'Asia', year: '1800', value: 635,},
{ country: 'Europe', year: '1750', value: 163,},
{ country: 'Europe', year: '1800', value: 203,},
];
const areaPlot = new PercentageStackArea(document.getElementById('container'), {
title: {
visible: true,
text: '百分比堆叠面积图',
},
data,
meta: { year: { alias:'年份' range: [0, 1], }, value: { alias: '数量', formatter:(v)=>{return `${v}个`} } }, xField: 'year',
yField: 'value',
stackField: 'country',
});
areaPlot.render();angleField 📌
必选, string
功能描述： 雷达图映射到圆周角度所对应的字段，一般为一个分类字段。
默认配置： 无
radiusField 📌
必选, string
功能描述： 雷达图映射到半径所对应的字段，一般为一个连续字段。
默认配置： 无
seriesField 📌
必选, string
功能描述： 对雷达图进行分组的字段，一般对应一个分类字段。通过该字段的值，雷达图将会被分为多个组，通过颜色进行区分，并上下重叠。
默认配置： 无
图形样式
color
可选, string[] | Function
功能描述： 指定颜色，即可以指定一系列色值，也可以通过回调函数的方法根据对应数值进行设置。
默认配置：采用 theme 中的色板。
smooth ✨
可选, boolean
功能描述： 是否以曲线的形态绘制 (spline)。
默认配置: false
area ✨
可选, object
功能描述： 配置雷达图上的颜色填充
默认配置：
visible: true,
style: {
opacity: 0.25,
}| 细分配置 | 类型 | 功能描述 |
|---|---|---|
| visible | boolean | 是否显示 |
| style | object | 颜色填充样式 - fill: string 填充色 - stroke: string 描边颜色 - lineWidth: number 描边粗细 - lineDash: number 虚线描边 - opacity: number 透明度 - fillOpacity: number 填充透明度 - strokeOpacity: number 描边透明度 |
point ✨
可选, object
功能描述： 配置雷达图上的点
默认配置：
visible: false,
shape: 'circle',
size: 4| 细分配置 | 类型 | 功能描述 |
|---|---|---|
| visible | boolean | 是否显示 |
| shape | string | 数据点形状 |
| size | number | 数据点大小 |
| style | object | 数据点样式 - fill: string 填充色 - stroke: string 描边颜色 - lineWidth: number 描边粗细 - lineDash: number 虚线描边 - opacity: number 透明度 - fillOpacity: number 填充透明度 - strokeOpacity: number 描边透明度 |
line ✨
可选, object
功能描述：配置雷达图上的折线。
默认配置：
visible: false
size: 2
style:{
opacity: 1,
lineJoin: 'round',
lineCap: 'round',
}| 细分配置 | 类型 | 功能描述 |
|---|---|---|
| visible | boolean | 是否显示 |
| size | number | 折线的宽度 |
| style | object | 折线样式 - stroke: string 折线颜色 - lineDash: number[] 虚线显示 - opacity: number 透明度 |
图表组件
title
可选, optional
功能描述： 配置图表的标题，默认显示在图表左上角。
默认配置：
visible: false,
alignTo: 'left',
text:'',
style:{
fontSize: 18,
fill: 'black',
}| 细分配置 | 类型 | 功能描述 |
|---|---|---|
| visible | boolean | 是否显示 |
| alignTo | string | 位置，支持三种配置： 'left' |
| style | object | 样式： - fontSize: number 文字大小 - fill: string 文字颜色 - stroke: string 描边颜色 - lineWidth: number 描边粗细 - lineDash: number 虚线描边 - opacity: number 透明度 - fillOpacity: number 填充透明度 - strokeOpacity: number 描边透明度 |
description
可选, optional
功能描述： 配置图表的描述，默认显示在图表左上角，标题下方。
默认配置：
visible: false,
alignTo: 'left',
text:'',
style:{
fontSize: 12,
fill: 'grey',
}| 细分配置 | 类型 | 功能描述 |
|---|---|---|
| visible | boolean | 是否显示 |
| alignTo | string | 位置，支持三种配置： 'left' |
| style | object | 样式： - fontSize: number 文字大小 - fill: string 文字颜色 - stroke: string 描边颜色 - lineWidth: number 描边粗细 - lineDash: number 虚线描边 - opacity: number 透明度 - fillOpacity: number 填充透明度 - strokeOpacity: number 描边透明度 |
angleAxis ✨
可选, object
功能描述： 雷达图角度轴配置
默认配置：
visible: true,
line: {
visible: false,
},
tickLine: {
visible: false,
},
grid: {
visible: true,
line: {
style: {
lineDash: [0, 0],
},
},
},
label: {
visible: true,
offset: 8,
autoRotate: true,
autoHide: true
},
title: {
visible: false,
}| 细分配置 | 类型 | 功能描述 |
|---|---|---|
| visible | boolean | 是否可见 |
| line | object | 坐标轴轴线 - visible: boolean 是否可见 - style：object 轴线样式 |
| grid | object | 网格线 - visible: boolean 是否可见 - line：object 网格线样式 |
| label | object | 坐标轴标签 - visible: boolean 是否可见 - formatter: function 坐标轴标签格式化 - suffix: string 后缀 - precision：number 标签精度，如配置为 2，则格式化为 2 位小数 - mask: string 为日期文本添加格式化遮罩，当坐标轴type为time时生效 - offsetX: number 位置在x方向上的偏移量 - offsetY：number 位置在y方向上的偏移量 - style：object 样 -autoHide: boolean 是否自动隐藏 -autoRotate: boolean 是否自动旋转 |
| tickLine | object | 坐标轴刻度 - visible：boolean 是否可见 - style: object 样式 |
| title | object | 坐标轴标题 - visible： boolean 是否可见 - text: string 标题文字 - offset: number 位置偏移量 - style：object 样式 |
radiusAxis ✨
可选, object
功能描述： 雷达图径向轴配置
默认配置：
min: 0,
visible: true,
nice: true,
line: {
visible: true,
},
tickLine: {
visible: true,
},
gridType: 'line',
grid: {
visible: true,
line: {
style: {
lineDash: [0, 0],
},
},
},
label: {
visible: true,
autoRotate: true,
autoHide: true
},
title: {
visible: false,
}| 细分配置 | 类型 | 功能描述 |
|---|---|---|
| visible | boolean | 是否可见 |
| tickCount | number | 坐标轴刻度数量 |
| tickInterval | number | 坐标轴刻度间隔 |
| min | number | 设置坐标轴最小值 |
| max | number | 设置坐标轴最大值 |
| line | object | 坐标轴轴线 - visible: boolean 是否可见 - style：object 轴线样式 |
| grid | object | 网格线 - visible: boolean 是否可见 - line：object 网格线样式 |
| label | object | 坐标轴标签 - visible: boolean 是否可见 - formatter: function 坐标轴标签格式化 DEMO - suffix: string 后缀 - precision：number 标签精度，如配置为 2，则格式化为 2 位小数 - offsetX: number 位置在x方向上的偏移量 - offsetY：number 位置在y方向上的偏移量 - style：object 样 -autoHide: boolean 是否自动隐藏 -autoRotate: boolean 是否自动旋转 |
| tickLine | object | 坐标轴刻度 - visible：boolean 是否可见 - style: object 样式 |
| title | object | 坐标轴标题 - visible： boolean 是否可见 - text: string 标题文字 - offset: number 位置偏移量 - style：object 样式 |
| gridType | string | 网格线类型。* line: 使用直线绘制网格线 * arc: 使用曲线绘制网格线 |
| gridAlternateColor | string | 网格线间隔区间的填充颜色，默认不显色 |
legend
可选, object
功能描述：图例，多折线时显示，用于展示颜色分类信息
默认配置：
visible: true,
position: 'bottom',
flipPage: true| 细分配置 | 类型 | 功能描述 |
|---|---|---|
| visible | boolean | 是否可见 |
| position | string | 位置，支持12方位布局 top-left, top-center,top-right bottom-left,bottom-center,bottom-right left-top,left-center,left-bottom right-top,right-center,right-bottom |
| formatter | function | 对图例显示信息进行格式化 |
| offsetX | number | 图例在 position 的基础上再往 x 方向偏移量，单位 px |
| offsetY | number | 图例在 position 的基础上再往 y 方向偏移量，单位 px |
| title | object | 图例标题 - visible: boolean 是否显示 - text: string 图例文本，如不配置则自动取对应字段名 - style: object 标题样式 |
| marker | object | 图例 marker - symbol: string marker符号，默认为 'circle'。可选类型：circle,square,diamond,triangle,triangleDown,hexagon,bowtie,cross,tick,plus,hyphen,line,hollowCircle,hollowSquare,hollowDiamond - style: object marker样式，其中 r 配置marker的大小，其余样式参数参考绘图属性文档。 |
| text | object | 图例文本 - style: object 配置图例文本样式 - formatter:(text,cfg)=>string 格式化图例文本 |
tooltip
可选, object
功能描述：信息提示框
默认配置：
visible: true,
shared: true,
showCrosshairs: false,
crosshairs: {
type: 'y'
},
offset: 20,| 细分属性 | 类型 | 功能描述 |
|---|---|---|
| visible | boolean | 是否显示 |
| offset | number | 距离鼠标位置偏移值 |
| shared | boolean | 是否同时显示多条数据 |
| showCrosshairs | boolean | 是否tooltip辅助线 |
| crosshairs | object | 配置tooltip辅助线。 -type: string crosshairs类型,可选项： x |
| domStyles | object | 配置tooltip样式 - g2-tooltip: object 设置tooltip容器的CSS样式 - g2-tooltip-title: object 设置tooltip标题的CSS样式 - g2-tooltip-list: object 设置tooltip列表容器的CSS 样式 - g2-tooltip-marker: object 设置tooltip列表容器中每一项 marker的CSS样式 - g2-tooltip-value: object 设置tooltip 列表容器中每一项 value的CSS样式 |
| fields | string | 设置tooltip内容字段，默认为[ angleField, radiusField, seriesField ] |
| formatter | object | 对tooltip items进行格式化，入参为tooltip fields对应数值，出参为格式为{name:'a',value:1} |
label
功能描述： 标签文本
默认配置：
visible: false
type:'point'
offsetX: 6
offsetY: 6
style:{
fill: 'rgba(0, 0, 0, 0.65)',
stroke: '#ffffff',
lineWidth: 2,
}| 细分配置 | 类型 | 功能描述 |
|---|---|---|
| visible | boolean | 是否显示 |
| autoRotate | boolean | 是否自动旋转 |
| formatter | function | 对文本标签内容进行格式化 |
| offsetX | number | 在 label 位置的基础上再往 x 方向的偏移量 |
| offsetY | number | 在 label 位置的基础上再往 y 方向的偏移量 |
| style | object | 配置文本标签样式。 |
事件
面积事件
| onAreaClick 面积点击事件 | onAreaDblClick 面积双击事件 | onAreaDblClick 面积双击事件 | onAreaMouseleave 面积鼠标离开事件 |
|---|---|---|---|
| onAreaMousemove 面积鼠标移动事件 | onAreamousedown 面积鼠标按下事件 | onAreaMouseup 面积鼠标松开事件 | onAreaMouseenter 面积鼠标进入事件 |
折线事件
| onLineClick 折线点击事件 | onLineDblClick 折线双击事件 | onLineDblClick 折线双击事件 | onLineMouseleave 折线鼠标离开事件 |
|---|---|---|---|
| onLineMousemove 折线鼠标移动事件 | onLineMousedown 折线鼠标按下事件 | onLineMouseup 折线鼠标松开事件 | onLineMouseenter 折线鼠标进入事件 |
数据点事件
| onPointClick 数据点点击事件 | onPointDblClick 数据点双击事件 | onPointDblClick 数据点双击事件 | onPointMouseleave 数据点鼠标离开事件 |
|---|---|---|---|
| onPointMousemove 数据点鼠标移动事件 | onPointMousedown 数据点鼠标按下事件 | onPointMouseup 数据点鼠标松开事件 | onPointMouseenter 数据点鼠标进入事件 |
图表区域事件
| onPlotClick 图表区域点击事件 | onPlotDblClick 图表区域双击事件 | onPlotDblClick 图表区域双击事件 | onPlotMouseleave 图表区域鼠标离开事件 |
|---|---|---|---|
| onPlotMousemove 图表区域鼠标移动事件 | onPlotMousedown 图表区域鼠标按下事件 | onPlotMouseup 图表区域鼠标松开事件 | onPlotMouseenter 图表区域鼠标进入事件 |
图例事件
| onLegendClick 图例点击事件 | onLegendDblClick 图例双击事件 | onLegendMouseenter 图例鼠标进入事件 | onLegendMouseleave 图例鼠标离开事件 |
|---|---|---|---|
| onLegendMousemove 图例鼠标移动事件 | onLegendMousedown 图例鼠标按下事件 | onLegendMouseup 图例鼠标松开事件 | onLegendMouseenter 图例鼠标进入事件 |
坐标轴事件
| onAxisClick 坐标轴点击事件 | onAxisDblClick 坐标轴双击事件 | onAxisDblClick 坐标轴双击事件 | onAxisMouseleave 坐标轴鼠标离开事件 |
|---|---|---|---|
| onAxisMousemove 坐标轴鼠标移动事件 | onAxisMousedown 坐标轴鼠标按下事件 | onAxisMouseup 坐标轴鼠标松开事件 | onAxiMouseenter 坐标轴鼠标进入事件 |
图形标签事件
| onLabelClick 图形标签点击事件 | onLabelDblClick 图形标签双击事件 | onLabelDblClick 图形标签双击事件 | onLabelMouseleave 图形标签鼠标离开事件 |
|---|---|---|---|
| onLabelMousemove 图形标签鼠标移动事件 | onLabelMousedown 图形标签鼠标按下事件 | onLabelMouseup 图形标签鼠标松开事件 | onLabelMouseenter 图形标签鼠标进入事件 |
标题事件
| onTitleClick 标题点击事件 | onTitleDblClick 标题双击事件 | onTitleDblClick 标题双击事件 | onTitleMouseleave 标题鼠标离开事件 |
|---|---|---|---|
| onTitleMousemove 标题鼠标移动事件 | onTitleMousedown 标题鼠标按下事件 | onTitleMouseup 标题鼠标松开事件 | onTitleMouseenter 标题鼠标进入事件 |
描述事件
| onDescriptionClick 标题点击事件 | onDescriptionDblClick 标题双击事件 | onDescriptionDblClick 标题双击事件 | onDescriptionMouseleave 标题鼠标离开事件 |
|---|---|---|---|
| onDescriptionMousemove 标题鼠标移动事件 | onDescriptionMousedown 标题鼠标按下事件 | onDescriptionMouseup 标题鼠标松开事件 | onDescriptionMouseenter 标题鼠标进入事件 |
图表方法
render() 📌
必选
渲染图表。
updateConfig()
可选
更新图表配置项。
plot.updateConfig({
width: 500,
height: 600,
legend: {
visible: false,
},
});
plot.render();changeData()
可选
更新图表数据。updateConfig()方法会导致图形区域销毁并重建，如果只进行数据更新，而不涉及其他配置项更新，推荐使用本方法。
plot.changeData(newData);repaint()
可选
图表画布重绘。
destroy()
可选
销毁图表。
getData()
获取图表数据。
getPlotTheme()
获取图表 theme。