singleAxis组件基本使用

这一章介绍了 ECharts singleAxis 组件的使用以及它的一些基本属性。

singleAxis

singleAxis 是 ECharts 中的单轴。它可以被应用到散点图中展现一维数据，如下示例：

singleAxis.zlevel

number [ 默认值 0 ]

设置所有单轴图形的 zlevel 值。

zlevel用于 Canvas 分层，不同zlevel值的图形会放置在不同的 Canvas 中，Canvas 分层是一种常见的优化手段。

可以把一些图形变化频繁（例如有动画）的组件设置成一个单独的zlevel。需要注意的是过多的 Canvas 会引起内存开销的增大，在手机端上需要谨慎使用以防崩溃。

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

singleAxis.z

number [ 默认值 2 ]

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

z相比zlevel优先级更低，而且不会创建新的 Canvas。

singleAxis.left

string, number [ 默认值 '5%' ]

singleAxis 组件离容器左侧的距离。

left 的值可以是像 20 这样的具体像素值，可以是像 '20%' 这样相对于容器高宽的百分比，也可以是 'left', 'center', 'right'。

如果 left 的值为'left', 'center', 'right'，组件会根据相应的位置自动对齐。

singleAxis.top

string, number [ 默认值 '5%' ]

singleAxis 组件离容器上侧的距离。

top 的值可以是像 20 这样的具体像素值，可以是像 '20%' 这样相对于容器高宽的百分比，也可以是 'top', 'middle', 'bottom'。

如果 top 的值为'top', 'middle', 'bottom'，组件会根据相应的位置自动对齐。

singleAxis.right

string, number [ 默认值 '5%' ]

singleAxis 组件离容器右侧的距离。

right 的值可以是像 20 这样的具体像素值，可以是像 '20%' 这样相对于容器高宽的百分比。

singleAxis.bottom

string, number [ 默认值 '5%' ]

singleAxis 组件离容器下侧的距离。

bottom 的值可以是像 20 这样的具体像素值，可以是像 '20%' 这样相对于容器高宽的百分比。

singleAxis.width

string, number [ 默认值 'auto' ]

singleAxis 组件的宽度。默认自适应。

singleAxis.height

string, number [ 默认值 'auto' ]

singleAxis 组件的高度。默认自适应。

singleAxis.orient

string [ 默认值 'horizontal' ]

singleAxis 组件轴的朝向，默认水平朝向，可以设置成 'vertical' 垂直朝向。

singleAxis.type

string [ 默认值 'value' ]

坐标轴类型。

可选：

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

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

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

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

singleAxis.name

string 坐标轴名称。

singleAxis.nameLocation

string [ 默认值 'end' ]

坐标轴名称显示位置。

可选：

• 'start'
• 'middle' 或者 'center'
• 'end'

singleAxis.nameTextStyle

Object 坐标轴名称的文字样式。

singleAxis.nameGap

number [ 默认值 15 ]

坐标轴名称与轴线之间的距离。

singleAxis.nameRotate

number [ 默认值 null ]

坐标轴名字旋转，角度值。

singleAxis.inverse

boolean [ 默认值 false ]

是否是反向坐标轴。ECharts 3 中新加。

singleAxis.boundaryGap

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

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

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

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

singleAxis.min

number, string, function [ 默认值 null ]

坐标轴刻度最小值。

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

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

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

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

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

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

singleAxis.max

number, string [ 默认值 null ]

坐标轴刻度最大值。

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

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

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

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

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

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

singleAxis.scale

boolean [ 默认值 false ]

只在数值轴中（type: 'value'）有效。

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

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

singleAxis.splitNumber

number [ 默认值 5 ]

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

在类目轴中无效。

singleAxis.minInterval

number [ 默认值 0 ]

自动计算的坐标轴最小间隔大小。

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

{
    minInterval: 1
}

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

singleAxis.maxInterval

number 自动计算的坐标轴最大间隔大小。

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

{
    maxInterval: 3600 * 24 * 1000
}

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

singleAxis.interval

number 强制设置坐标轴分割间隔。

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

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

singleAxis.logBase

number [ 默认值 10 ]

对数轴的底数，只在对数轴中（type: 'log'）有效。

singleAxis.silent

boolean [ 默认值 false ]

坐标轴是否是静态无法交互。

singleAxis.triggerEvent

boolean [ 默认值 false ]

坐标轴的标签是否响应和触发鼠标事件，默认不响应。

事件参数如下：

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