JSRUN 用代码说话

极坐标系的径向轴属性

编辑教程

极坐标系的径向轴

在 ECharts 中包含了一个径向轴和一个角度轴,本章先来对径向轴做出详细的介绍。ECharts 通过 radiusAxis 来表示极坐标系的径向轴。详细的内容在之后的章节中会进行介绍。

径向轴的属性设置

本节开始将详细来讲述在 ECharts 图表中是如何设置径向轴的属性的。ECharts径向轴常见的属性包括其所在极坐标系的索引、径向轴的类型、判断径向轴是否反向、径向轴名称的显示、径向轴的刻度最值等等,这里就不一一列举了,想要知道更加具体的内容,您可以往下阅读。


radiusAxis.polarIndex

number [ 默认值: 0 ]

径向轴所在的极坐标系的索引,默认使用第一个极坐标系。


radiusAxis.type

string [ 默认值: 'value' ]

径向轴的类型。

可选:

  • 'value' :数值轴,适用于连续数据。

  • 'category' :类目轴,适用于离散的类目数据,为该类型时必须通过 data 设置类目数据。

  • 'time' :时间轴,适用于连续的时序数据,与数值轴相比时间轴带有时间的格式化,在刻度计算上也有所不同,例如会根据跨度的范围来决定使用月,星期,日还是小时范围的刻度。

  • 'log' :对数轴。适用于对数数据。


radiusAxis.name

string 径向轴的名称。在下节内容中我们会对径向轴名称的文本样式进行设置。


radiusAxis.nameLocation

string [ 默认值: 'end' ]

径向轴名称的显示位置。

可选:

  • 'start'
  • 'middle'
  • 'end'

radiusAxis.nameGap

number [ 默认值: 15 ]

径向轴名称与轴线之间的距离。


radiusAxis.nameRotate

number [ 默认值: null ]

径向轴名称旋转,角度值。


radiusAxis.inverse

boolean [ 默认值: false ]

是否是反向径向轴。该属性在 ECharts 3 中新加。


radiusAxis.boundaryGap

boolean, Array 径向轴两边留白策略,类目轴和非类目轴的设置和表现不一样。

类目轴中 boundaryGap 可以配置为 true 和 false。默认为 true,这时候刻度只是作为分隔线,标签和数据点都会在两个刻度之间的带(band)中间。

非类目轴,包括时间,数值,对数轴,boundaryGap是一个两个值的数组,分别表示数据最小值和最大值的延伸范围,可以直接设置数值或者相对的百分比,在设置 min 和 max 后无效。 示例:

boundaryGap: ['20%', '20%']


radiusAxis.min

number, string, function [ 默认值: null ]

径向轴刻度的最小值。

可以设置成特殊值 'dataMin',此时取数据在该轴上的最小值作为最小刻度。

不设置时会自动计算最小值保证坐标轴刻度的均匀分布。

在类目轴中,也可以设置为类目的序数(如类目轴 data: ['类A', '类B', '类C'] 中,序数 2 表示 '类C'。也可以设置为负数,如 -3)。

当设置成 function 形式时,可以根据计算得出的数据最大最小值设定坐标轴的最小值。如:

min: function(value) {    return value.min - 20;}

其中 value 是一个包含 min 和 max 的对象,分别表示数据的最大最小值,这个函数应该返回坐标轴的最小值。


radiusAxis.max

number, string [ 默认值: null ]

径向轴刻度的最大值。

可以设置成特殊值 'dataMax',此时取数据在该轴上的最大值作为最大刻度。

不设置时会自动计算最大值保证坐标轴刻度的均匀分布。

在类目轴中,也可以设置为类目的序数(如类目轴 data: ['类A', '类B', '类C'] 中,序数 2 表示 '类C'。也可以设置为负数,如 -3)。

当设置成 function 形式时,可以根据计算得出的数据最大最小值设定坐标轴的最小值。如:

max: function(value) {    return value.max - 20;}

其中 value 是一个包含 min 和 max 的对象,分别表示数据的最大最小值,这个函数应该返回坐标轴的最大值。


radiusAxis.scale

boolean [ 默认值: false ]

只在数值轴中(type: 'value')有效。

是否是脱离 0 值比例。设置成 true 后坐标刻度不会强制包含零刻度。在双数值轴的散点图中比较有用。

在设置 min 和 max 之后该配置项无效。


radiusAxis.splitNumber

number [ 默认值: 5 ]

径向轴的分割段数,需要注意的是这个分割段数只是个预估值,最后实际显示的段数会在这个基础上根据分割后坐标轴刻度显示的易读程度作调整。

在类目轴中无效。


radiusAxis.minInterval

number [ 默认值: 0 ]

自动计算的径向轴最小间隔大小。

例如可以设置成1保证坐标轴分割刻度显示成整数。

{
    minInterval: 1
}

只在数值轴或时间轴中(type: 'value' 或 'time')有效。


radiusAxis.maxInterval

number 自动计算的径向轴最大间隔大小。

例如,在时间轴((type: 'time'))可以设置成 3600 24 1000 保证坐标轴分割刻度最大为一天。

{
    maxInterval: 3600 * 24 * 1000
}

只在数值轴或时间轴中(type: 'value' 或 'time')有效。


radiusAxis.interval

number 强制设置径向轴分割间隔。

因为 splitNumber 是预估的值,实际根据策略计算出来的刻度可能无法达到想要的效果,这时候可以使用 interval 配合 min、max 强制设定刻度划分,一般不建议使用。

无法在类目轴中使用。在时间轴(type: 'time')中需要传时间戳,在对数轴(type: 'log')中需要传指数值。


radiusAxis.logBase

number [ 默认值: 10 ]

对数轴的底数,只在对数轴中(type: 'log')有效。


radiusAxis.silent

boolean [ 默认值: false ]

径向轴是否是静态无法交互。


radiusAxis.triggerEvent

boolean [ 默认值: false ]

径向轴的标签是否响应和触发鼠标事件,默认不响应。

事件参数如下:

{
    // 组件类型,xAxis, yAxis, radiusAxis, angleAxis
    // 对应组件类型都会有一个属性表示组件的 index,例如 xAxis 就是 xAxisIndex
    componentType: string,
    // 未格式化过的刻度值, 点击刻度标签有效
    value: '',
    // 坐标轴名称, 点击坐标轴名称有效
    name: ''
}

radiusAxis.zlevel

number [ 默认值: 0 ]

径向轴所有图形的 zlevel 值。

zlevel用于 Canvas 分层,不同zlevel值的图形会放置在不同的 Canvas 中,Canvas 分层是一种常见的优化手段。我们可以把一些图形变化频繁(例如有动画)的组件设置成一个单独的zlevel。需要注意的是过多的 Canvas 会引起内存开销的增大,在手机端上需要谨慎使用以防崩溃。

zlevel 大的 Canvas 会放在 zlevel 小的 Canvas 的上面。


radiusAxis.z

number [ 默认值: 0 ]

径向轴组件的所有图形的z值。控制图形的前后顺序。z 值小的图形会被z值大的图形覆盖。

z 相比 zleve l优先级更低,而且不会创建新的 Canvas。

JSRUN闪电教程系统是国内最先开创的教程维护系统, 所有工程师都可以参与共同维护的闪电教程,让知识的积累变得统一完整、自成体系。 大家可以一起参与进共编,让零散的知识点帮助更多的人。
X
支付宝
9.99
无法付款,请点击这里
金额: 0
备注:
转账时请填写正确的金额和备注信息,到账由人工处理,可能需要较长时间
如有疑问请联系QQ:565830900
正在生成二维码, 此过程可能需要15秒钟