ECharts 入门教程 ECharts工具栏组件(toolbox)

2024-02-25 开发教程 ECharts 入门教程 匿名 6

toolbox

在 ECharts 图表的工具栏(toolbox)中,有五个内置的工具,分别是:导出图片,数据视图,动态类型切换,数据区域缩放以及配置项还原,这五个工具的配置在 feature 属性中实现配置。本节在介绍 toolbox 的基本属性时先不讲解 feature 而是将其在下一节中独立介绍。

如下示例:

点击编辑实例 》》

toolbox.show | boolean

[ default: true ]

是否显示工具栏组件。

toolbox.orient | string

[ default: 'horizontal' ]

工具栏 icon 的布局朝向。

可选:

  • 'horizontal'
  • 'vertical'

toolbox.itemSize | number

[ default: 15 ]

工具栏 icon 的大小。

toolbox.itemGap | number

[ default: 10 ]

工具栏 icon 每项之间的间隔。横向布局时为水平间隔,纵向布局时为纵向间隔。

toolbox.showTitle | boolean

[ default: true ]

是否在鼠标 hover 的时候显示每个工具 icon 的标题。

toolbox.zlevel | number

[ default: 0 ]

所有工具栏图形的 zlevel 值。

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

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

toolbox.z | number

[ default: 2 ]

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

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

toolbox.left | string, number

[ default: 'auto' ]

工具栏组件离容器左侧的距离。

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

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

toolbox.top | string, number

[ default: 'auto' ]

工具栏组件离容器上侧的距离。

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

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

toolbox.right | string, number

[ default: 'auto' ]

工具栏组件离容器右侧的距离。

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

默认自适应。

toolbox.bottom | string, number

[ default: 'auto' ]

工具栏组件离容器下侧的距离。

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

默认自适应。

toolbox.width | string, number

[ default: 'auto' ]

工具栏组件的宽度。默认自适应。

toolbox.height | string, number

[ default: 'auto' ]

工具栏组件的高度。默认自适应。