1 Star 0 Fork 676

jack / uCharts

forked from uCharts / uCharts 
加入 Gitee
与超过 1200万 开发者一起发现、参与优秀开源项目,私有仓库也完全免费 :)
免费加入
克隆/下载
README.md 11.22 KB
一键复制 编辑 原始数据 按行查看 历史
16cheng 提交于 2019-07-14 22:00 . 2019年7月第2周累积更新

🎊 喜讯!《uCharts 高性能跨全端图表》荣获插件大赛一等奖。

感谢 DCloud 以及 MPvue 团队的鼓励和认可!感谢各位开发者的问题反馈和赞赏!uCharts 团队一定不负众望,为大家打造完美、易用、高性能的图表而奋斗!再次感谢!

最近更新

  • 2019.07.13 修改updateData方法,不仅仅限于categoriesseries更新,支持全部opts参数更新,支持变更图表类型,等同于new uCharts({})。
  • 2019.07.13 更正 饼图、圆环图、玫瑰图 的扩展配置labelWidth,之前的lableWidth拼写错误,更新版本后请注意替换,给您带来的不便请谅解。
  • 2019.07.12 增加 opts.extra.gauge.labelFormat 仪表盘数据标签格式化。示例:opts.extra.gauge.labelFormat:function(val){return val.toFixed(2)}。
  • 2019.07.12 修复温度计图表个别情况下边框留空问题。
  • 2019.07.09 新增 opts.xAxis.gridEval X轴网格线显示间隔,即假设为2时,是隔一个刻度显示间隔 |
  • 2019.07.09 新增 opts.series.addPoint 参数,混合图中是否增加折线或区域图上的标记点,仅针对 line , area 有效。
  • 2019.07.09 修复混合图中类型为point的时候,如设置 opts.dataPointShape 为false的情况下不显示标记点的bug。
  • 2019.07.09 修改 module.exports 方法,增加判断,兼容vue及H5方式普通引用。
  • 2019.07.07 修复自定义数据标签在饼图无效的bug。
  • 2019.07.04 新增 opts.duration 动画展示时长单位毫秒。
  • 2019.07.01 新增 opts.yAxis.fontSize 参数,用于控制 Y 轴标签的字体大小。
  • 2019.07.01 新增 opts.xAxis.fontSize 参数,用于控制 X 轴标签的字体大小。
  • 2019.07.01 新增 opts.series.textSize 参数,用于控制数据标签的字体大小。
  • 2019.06.30 新增玫瑰图,详见 demo。
  • 2019.06.30 新增雷达图 ToolTip 效果,详见雷达图 demo。
  • 2019.06.28 新增 component.vue 组件,并提供组件下使用 uCharts 应用示例。
  • 2019.06.26 新增各厂商小程序原生调用 JS 文件支持(非 uin-app 项目),详见 gitee 码云首页目录示例。
  • 2019.06.26 新增对 dataLabel 字体颜色的控制,增加opts.series.textColor 参数。
  • 2019.06.25 优化 29 处 forEach 循环,更替为 for 循环。
  • 2019.06.24 将 K 线的均线挂载到 opts 上,方便调用。更改 demo 网络请求地址。
  • 2019.06.23 完善 K 线图,增加 K 线图与柱状图联动 demo,详见应用 -> K 线图与柱状图联动。
  • 2019.06.22 增加 opts.xAxis.labelCount 参数,X 轴可见区域标签数量(即 X 轴数刻度标签单屏幕限制显示的数量),用于解决 X 轴文案问题。
  • 2019.06.22 优化拖拽事件,增加 opts.extra.touchMoveLimit 图表拖拽时,每秒重新渲染的帧数,针对图表拖拽卡顿。
  • 2019.06.17 增加 updateData 更新图表时,是否显示动画效果 animation ,参见 API 更新图表方法。
  • 2019.06.17 增加 updateData 更新图表时,滚动条位置设置scrollPosition,参见 API 更新图表方法。

uCharts 官方网站

https://www.ucharts.cn

码云 gitee 开源地址

小伙伴们,需要 star 哦~~~

在线文档(参数在 API 章节)

QQ交流群:371774600

口令【gitee

快速体验

一套代码编到 7 个平台,依次扫描二维码,亲自体验 uCharts 图表跨平台效果!iOS 因 demo 比较简单无法上架,请自行编译。

更新记录

未来计划(V1.0 至 2.0 版本)

  • 2019.07.xx 计划加入 条状图漏斗图
  • 2019.07.xx 推迟计划加入 第二种仪表盘样式,增加《亲手教您如何改造 uCharts,打造您的专属图表》教程。
  • 2019.07.xx 计划加入 渐变颜色填充 功能,支持柱状图、区域图、混合图、圆弧进度条
  • 2019.07.xx 计划修复折线图样式为曲线时,个别情况下曲线超出 X 轴的问题。
  • 2019.07.xx 计划加入 辅助线(标记线) 功能,支持 柱状图、折线图、区域图、K线图、混合图
  • 2019.07.xx 计划修复x轴文案旋转遮挡不完整并覆盖滚动条,增加XY轴线配置,增加图表起始点为X轴0点开始的配置。
  • 2019.07.xx 计划加入双 Y 轴功能,支持 Y 轴双坐标系。

未来计划(全新 V2.0 版本)

2019.5.20 重要又浪漫的日期,uCharts 团队正式成立了。

我们将以追求极致、追求完美的极客精神来打造 uCharts。uCharts2.0 版本正在前期策划中,将以全新结构重写 uCharts,支持多 Y 轴、多 X 轴、自定义图例位置、以及更多图表类型,请各位敬请期待。

支持图表类型

  • 饼图 Pie
  • 圆环图 Ring
  • 线图 Line(直线、曲线)
  • 柱状图 Column(分组、堆叠、温度计)
  • 区域图 Area(直线、曲线)
  • 雷达图 Radar
  • 圆弧进度图 Arcbar
  • 仪表盘 Gauge
  • K线图 Candle
  • 混合图 Mix(支持 Point、Line 直线曲线、Column、Area 直线曲线)
  • 玫瑰图 Rose(面积模式、半径模式)
  • 条状图 Bar(开发中)
  • 漏斗图 Funnel(开发中)

插件特点

  • 改造后的插件可以跨端使用,支持 H5、小程序(微信/支付宝/百度/头条)、APP,调用简单方便、性能及体验极佳。
  • 虽然没有 Echarts 及 F2 图表功能强大,但可以实现一套业务逻辑各端通用,并解决了支付宝小程序图表显示模糊等问题。
  • 支持单页面多图表,demo 中单页 10 个图表,响应速度超快。
  • 支持入场动画及 ToolTip 动画效果。
  • 独特支持 横屏模式 感谢 masterLi 提供需求。

为何不用 Echarts?

  • 相比 Echarts 及 F2 的复杂的设置,本插件几乎等于傻瓜式的配置。
  • Echarts 在跨端使用更复杂,本插件只需要简单的两个 <canvas> 标签轻松区别搞定,代码整洁易维护。
  • Echarts 在 iOS 端图表显示错位,只能引用网页解决。
  • 本插件打包后的体积相比 Echarts 小很多很多,所以性能更好。
  • 如果您是 uni-app 初学者,那么强烈建议您使用 uCharts,并且目前可以跨全端通用,减少工作量,增强一致性体验。
  • 图表样式均可自定义,懂 JS 的都可以读懂插件源码,直接修改 u-charts.js 源码即可。
  • 本插件经过大量测试,反复论证并加以改造而成,请各位放心使用。

uni-app 图表选型参考流程

亲手教您如何改造uCharts,打造您的专属图表

  • 为何要改造 uCharts?
  • 并不是所有图表插件直接拿来就可以满足客户需求,如果您的 UI 设计师设计一个图表,如下图:

  • 您会发现这个图表即使在 echarts 里也不是很好实现,那么就需要我们自己动手去实现。下面就让我们一起来完成,本文旨在抛砖引玉,希望各位朋友能够更好的应用 uCharts 来完成您的项目,如果您有更好的设计,请提交您的 PR 到 Github uCharts跨端图表,帮助更多朋友,感谢您的付出及贡献!

uCharts 跨端图表改造教程(暂未完成,请关注)

图表示例

常见问题

各位遇到问题请先参考以下问题,如果仍不能解决,请留言。

通用问题

  • 如果用在您的项目上图表不显示,请先运行 demo 页面,如果 demo 页面也无法显示,请查看全局样式是否定义了 canvas 的样式,如有请取消。
  • 图表背景颜色问题,很多朋友设置图表背景颜色时候,只修改了 viewcanvascss,忘记了修改实例化参数中的 background:'#FFFFFF',导致图表画板右侧有一道白条(这个是图表配置中的右边距),所以特修改了 demo 中的 柱状图 的背景颜色供大家参考。
  • 如果遇到 图表与预期尺寸不符合,请检查 canvas 标签上的 csscWidthcHeihgt 设置的值是否相符,css 请用 upx 为单位,cWidthcHeihgt 的单位为 px,请参考 demo 用 uni.upx2px() 方法转换。
  • 如遇到开启拖拽,而实际 无法拖拽 的情况,请先检查 canvas 标签是否绑定的 touch 事件。
  • 如果涉及到 v-if 切换显示图表组件,第二次可能会变空白,建议用 v-show 替代 v-if 切换显示图表组件。

头条问题

  • 头条小程序目前不支持拖拽事件,后续官方支持的话,不必更换 JS 文件,直接可用。

支付宝问题

  • 在高分屏模式下,如果发现图表已显示,但位置不正确,请检查上级 view 容器的 样式,为了解决高分屏 canvas 模糊问题,使用了css的 transform,所以请修改上级样式使 canvas 容器缩放至相应位置。
  • 如果将 canvas 放在多级组件下,遇到 ToolTip 不显示或点击区域不正确,请在 touch 事件中增加以下代码解决。
//#ifdef MP-ALIPAY
e.mp.currentTarget.offsetTop+=uni.upx2px(510);
//#endif

uni.upx2px(510); 是 canvas 组件的上级组件的高度

支付宝小程序 IDE 中不显示,但运行到真机是可以显示的,请真机测试。

JavaScript
1
https://gitee.com/yunduansky/uCharts.git
git@gitee.com:yunduansky/uCharts.git
yunduansky
uCharts
uCharts
master

搜索帮助