timeline组件实现切换、播放等操作

2024-06-01 06:48

本文主要是介绍timeline组件实现切换、播放等操作,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

timeline

timeline 组件,提供了在多个 ECharts option 间进行切换、播放等操作的功能。

示例效果如下:

timeline 和其他组件有些不同,它需要操作『多个option』。 假设,我们把 ECharts 的传统的 option 称为原子option,那么使用 timeline 时,传入 ECharts 的 option 就成为了一个集合多个原子option的复合option。如下示例:

// 如下,baseOption 是一个 『原子option』,options 数组中的每一项也是一个 『原子option』。
// 每个『原子option』中就是本文档中描述的各种配置项。
myChart.setOption({baseOption: {timeline: {...,data: ['2002-01-01', '2003-01-01', '2004-01-01']},title: {subtext: '数据来自国家统计局'},grid: {...},xAxis: [...],yAxis: [...],series: [{ // 系列一的一些其他配置type: 'bar',...},{ // 系列二的一些其他配置type: 'line',...},{ // 系列三的一些其他配置type: 'pie',...}]},options: [{ // 这是'2002-01-01' 对应的 optiontitle: {text: '2002年统计值'},series: [{data: []}, // 系列一的数据{data: []}, // 系列二的数据{data: []}  // 系列三的数据]},{ // 这是'2003-01-01' 对应的 optiontitle: {text: '2003年统计值'},series: [{data: []},{data: []},{data: []}]},{ // 这是'2004-01-01' 对应的 optiontitle: {text: '2004年统计值'},series: [{data: []},{data: []},{data: []}]}]}
);

在上例中,timeline.data 中的每一项,对应于 options 数组中的每个 option


使用注意与最佳实践:

  • 公有的配置项,推荐配置在 baseOption 中。timeline 播放切换时,会把 options 数组中的对应的 option,与 baseOption 进行 merge 形成最终的 option

  • options 数组中,如果某一数组项中配置了某个属性,那么其他数组项中也必须配置某个属性,而不能缺省。否则这个属性的执行效果会遗留。

  • 复合 option 中的 options 不支持 merge。

    也就是说,当第二(或三、四、五 ...)次 chart.setOption(rawOption) 时,如果 rawOption 是复合 option(即包含 options 列表),那么新的 rawOption.options 列表不会和老的 options 列表进行 merge,而是简单替代。当然,rawOption.baseOption 仍然会正常和老的 option 进行merge。


与 ECharts 2 的兼容性:

  • ECharts 3 中不再支持 timeline.notMerge 参数,也就是不支持 notMerge 模式。如果遇到这种场景需要使用,可在外部进行option管理,并用 setOption(option, true) 这样的notMerge方式设置。

  • ECharts 3 和 ECharts 2 相比,timeline 属性的定义位置有所不同,移到了 baseOption 中,统一作为一个普通的组件看待。但是,仍然兼容 ECharts2 的 timeline 定义位置,只是不再推荐这样写。

timeline.show  boolean
[ default: true ]

是否显示 timeline 组件。如果设置为false,不会显示,但是功能还存在。

timeline.type  string
[ default: 'slider' ]

这个属性目前只支持为 slider,不需要更改。

timeline.axisType  string
[ default: 'time' ]

轴的类型。可选值为:

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

  • 'category' 类目轴,适用于离散的类目数据。

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

timeline.currentIndex  number
[ default: 0 ]

表示当前选中项是哪项。比如,currentIndex 为 0 时,表示当前选中项为 timeline.data[0](即使用 options[0])。

timeline.autoPlay  boolean
[ default: false ]

表示是否自动播放。

timeline.rewind  boolean
[ default: false ]

表示是否反向播放。

timeline.loop  boolean
[ default: true ]

表示是否循环播放。

timeline.playInterval  number
[ default: 2000 ]

表示播放的速度(跳动的间隔),单位毫秒(ms)。

timeline.realtime  boolean
[ default: true ]

拖动圆点的时候,是否实时更新视图。

timeline.controlPosition  string
[ default: 'left' ]

表示『播放』按钮的位置。可选值:'left''right'

timeline.zlevel  number
[ default: 0 ]

所有图形的 zlevel 值。

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

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

timeline.z  number
[ default: 2 ]

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

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

timeline.left  string, number
[ default: 'auto' ]

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

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

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

timeline.top  string, number
[ default: 'auto' ]

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

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

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

timeline.right  string, number
[ default: 'auto' ]

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

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

默认自适应。

timeline.bottom  string, number
[ default: 'auto' ]

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

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

默认自适应。

timeline.padding  number, Array
[ default: 5 ]

timeline内边距,单位px,默认各方向内边距为5,接受数组分别设定上右下左边距。

使用示例:

// 设置内边距为 5
padding: 5
// 设置上下的内边距为 5,左右的内边距为 10
padding: [5, 10]
// 分别设置四个方向的内边距
padding: [5,  // 上10, // 右5,  // 下10, // 左
]
timeline.orient  string
[ default: 'horizontal' ]

摆放方式,可选值有:

  • 'vertical':竖直放置。
  • 'horizontal':水平放置。
timeline.inverse  boolean
[ default: false ]
  • 是否反向放置 timeline,反向则首位颠倒过来。
timeline.symbol  string
[ default: 'emptyCircle' ]

timeline标记的图形。

ECharts 提供的标记类型包括 'circle''rect''roundRect''triangle''diamond''pin''arrow'

也可以通过 'image://url' 设置为图片,其中 url 为图片的链接。

在 ECharts 3 里可以通过 'path://' 将图标设置为任意的矢量路径。这种方式相比于使用图片的方式,不用担心因为缩放而产生锯齿或模糊,而且可以设置为任意颜色。路径图形会自适应调整为合适(如果是 symbol 的话就是symbolSize)的大小。路径的格式参见 SVG PathData。可以从 Adobe Illustrator 等工具编辑导出。

timeline.symbolSize  number, Array
[ default: 10 ]

timeline标记的大小,可以设置成诸如 10 这样单一的数字,也可以用数组分开表示宽和高,例如 [20, 10] 表示标记宽为20,高为10

timeline.symbolRotate  number

timeline标记的旋转角度。注意在 markLine 中当 symbol 为 'arrow' 时会忽略 symbolRotate 强制设置为切线的角度。

timeline.symbolOffset  Array
[ default: [0, 0] ]

timeline标记相对于原本位置的偏移。默认情况下,标记会居中置放在数据对应的位置,但是如果 symbol 是自定义的矢量路径或者图片,就有可能不希望 symbol 居中。这时候可以使用该配置项配置 symbol 相对于原本居中的偏移,可以是绝对的像素值,也可以是相对的百分比。

例如 [0, '50%'] 就是把自己向上移动了一半的位置,在 symbol 图形是气泡的时候可以让图形下端的箭头对准数据点。

timeline.lineStyle  Object
timeline.label  Object

轴的文本标签。有 normal 和 emphasis 两个状态,normal 是文本正常的样式,emphasis 是文本高亮的样式,比如鼠标悬浮或者图例联动高亮的时候会使用 emphasis 作为文本的样式。

timeline.itemStyle  Object

timeline 图形样式,有 normal 和 emphasis 两个状态。normal 是图形在默认状态下的样式;emphasis 是图形在高亮状态下的样式,比如在鼠标悬浮或者图例联动高亮时。

timeline.checkpointStyle  Object

『当前项』(checkpoint)的图形样式。

timeline.controlStyle  Object

『控制按钮』的样式。『控制按钮』包括:『播放按钮』、『前进按钮』、『后退按钮』。

timeline.controlStyle.show  boolean
[ default: true ]

是否显示『控制按钮』。设置为 false 则全不显示。

timeline.controlStyle.showPlayBtn  boolean
[ default: true ]

是否显示『播放按钮』。

timeline.controlStyle.showPrevBtn  boolean
[ default: true ]

是否显示『后退按钮』。

timeline.controlStyle.showNextBtn  boolean
[ default: true ]

是否显示『前进按钮』。

timeline.controlStyle.itemSize  number
[ default: 22 ]

『控制按钮』的尺寸,单位为像素(px)。

timeline.controlStyle.itemGap  number
[ default: 12 ]

『控制按钮』的间隔,单位为像素(px)。

timeline.controlStyle.position  string
[ default: 'left' ]

『控制按钮』的位置。

  • 当 timeline.orient 为 'horizontal'时,'left''right'有效。

  • 当 timeline.orient 为 'vertical'时,'top''bottom'有效。

timeline.controlStyle.playIcon  string

『播放按钮』的『可播放状态』的图形。

在 ECharts 3 里可以通过 'path://' 将图标设置为任意的矢量路径。这种方式相比于使用图片的方式,不用担心因为缩放而产生锯齿或模糊,而且可以设置为任意颜色。路径图形会自适应调整为合适(如果是 symbol 的话就是symbolSize)的大小。路径的格式参见 SVG PathData。可以从 Adobe Illustrator 等工具编辑导出。

timeline.controlStyle.stopIcon  string

『播放按钮』的『可停止状态』的图形。

在 ECharts 3 里可以通过 'path://' 将图标设置为任意的矢量路径。这种方式相比于使用图片的方式,不用担心因为缩放而产生锯齿或模糊,而且可以设置为任意颜色。路径图形会自适应调整为合适(如果是 symbol 的话就是symbolSize)的大小。路径的格式参见 SVG PathData。可以从 Adobe Illustrator 等工具编辑导出。

timeline.controlStyle.prevIcon  string

『后退按钮』的图形

在 ECharts 3 里可以通过 'path://' 将图标设置为任意的矢量路径。这种方式相比于使用图片的方式,不用担心因为缩放而产生锯齿或模糊,而且可以设置为任意颜色。路径图形会自适应调整为合适(如果是 symbol 的话就是symbolSize)的大小。路径的格式参见 SVG PathData。可以从 Adobe Illustrator 等工具编辑导出。

timeline.controlStyle.nextIcon  string

『前进按钮』的图形

在 ECharts 3 里可以通过 'path://' 将图标设置为任意的矢量路径。这种方式相比于使用图片的方式,不用担心因为缩放而产生锯齿或模糊,而且可以设置为任意颜色。路径图形会自适应调整为合适(如果是 symbol 的话就是symbolSize)的大小。路径的格式参见 SVG PathData。可以从 Adobe Illustrator 等工具编辑导出。

timeline.controlStyle.normal  Object

控制按钮的『正常状态』的样式。

timeline.controlStyle.emphasis  Object

控制按钮的『高亮状态』的样式(hover时)。

timeline.data  Array

timeline 数据。Array 的每一项,可以是直接的数值。 如果需要对每个数据项单独进行样式定义,则数据项写成 ObjectObject中,value属性为数值。其他属性如下例子,可以覆盖 timeline 中的属性配置。

如下例:

['2002-01-01','2003-01-01','2004-01-01',{value: '2005-01-01',tooltip: {          // 让鼠标悬浮到此项时能够显示 `tooltip`。formatter: '{b} xxxx'},symbol: 'diamond',  // 此项的图形的特别设置。symbolSize: 16      // 此项的图形大小的特别设置。},'2006-01-01','2007-01-01','2008-01-01','2009-01-01','2010-01-01',{value: '2011-01-01',tooltip: {          // 让鼠标悬浮到此项时能够显示 `tooltip`。formatter: function (params) {return params.name + 'xxxx';}},symbol: 'diamond',symbolSize: 18},
]

这篇关于timeline组件实现切换、播放等操作的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/1020273

相关文章

分布式锁在Spring Boot应用中的实现过程

《分布式锁在SpringBoot应用中的实现过程》文章介绍在SpringBoot中通过自定义Lock注解、LockAspect切面和RedisLockUtils工具类实现分布式锁,确保多实例并发操作... 目录Lock注解LockASPect切面RedisLockUtils工具类总结在现代微服务架构中,分布

Java使用Thumbnailator库实现图片处理与压缩功能

《Java使用Thumbnailator库实现图片处理与压缩功能》Thumbnailator是高性能Java图像处理库,支持缩放、旋转、水印添加、裁剪及格式转换,提供易用API和性能优化,适合Web应... 目录1. 图片处理库Thumbnailator介绍2. 基本和指定大小图片缩放功能2.1 图片缩放的

python panda库从基础到高级操作分析

《pythonpanda库从基础到高级操作分析》本文介绍了Pandas库的核心功能,包括处理结构化数据的Series和DataFrame数据结构,数据读取、清洗、分组聚合、合并、时间序列分析及大数据... 目录1. Pandas 概述2. 基本操作:数据读取与查看3. 索引操作:精准定位数据4. Group

Python使用Tenacity一行代码实现自动重试详解

《Python使用Tenacity一行代码实现自动重试详解》tenacity是一个专为Python设计的通用重试库,它的核心理念就是用简单、清晰的方式,为任何可能失败的操作添加重试能力,下面我们就来看... 目录一切始于一个简单的 API 调用Tenacity 入门:一行代码实现优雅重试精细控制:让重试按我

Redis客户端连接机制的实现方案

《Redis客户端连接机制的实现方案》本文主要介绍了Redis客户端连接机制的实现方案,包括事件驱动模型、非阻塞I/O处理、连接池应用及配置优化,具有一定的参考价值,感兴趣的可以了解一下... 目录1. Redis连接模型概述2. 连接建立过程详解2.1 连php接初始化流程2.2 关键配置参数3. 最大连

Python实现网格交易策略的过程

《Python实现网格交易策略的过程》本文讲解Python网格交易策略,利用ccxt获取加密货币数据及backtrader回测,通过设定网格节点,低买高卖获利,适合震荡行情,下面跟我一起看看我们的第一... 网格交易是一种经典的量化交易策略,其核心思想是在价格上下预设多个“网格”,当价格触发特定网格时执行买

Python操作PDF文档的主流库使用指南

《Python操作PDF文档的主流库使用指南》PDF因其跨平台、格式固定的特性成为文档交换的标准,然而,由于其复杂的内部结构,程序化操作PDF一直是个挑战,本文主要为大家整理了Python操作PD... 目录一、 基础操作1.PyPDF2 (及其继任者 pypdf)2.PyMuPDF / fitz3.Fre

python设置环境变量路径实现过程

《python设置环境变量路径实现过程》本文介绍设置Python路径的多种方法:临时设置(Windows用`set`,Linux/macOS用`export`)、永久设置(系统属性或shell配置文件... 目录设置python路径的方法临时设置环境变量(适用于当前会话)永久设置环境变量(Windows系统

Python对接支付宝支付之使用AliPay实现的详细操作指南

《Python对接支付宝支付之使用AliPay实现的详细操作指南》支付宝没有提供PythonSDK,但是强大的github就有提供python-alipay-sdk,封装里很多复杂操作,使用这个我们就... 目录一、引言二、准备工作2.1 支付宝开放平台入驻与应用创建2.2 密钥生成与配置2.3 安装ali

Spring Security 单点登录与自动登录机制的实现原理

《SpringSecurity单点登录与自动登录机制的实现原理》本文探讨SpringSecurity实现单点登录(SSO)与自动登录机制,涵盖JWT跨系统认证、RememberMe持久化Token... 目录一、核心概念解析1.1 单点登录(SSO)1.2 自动登录(Remember Me)二、代码分析三、