1 Star 0 Fork 670

AlanQuain / uCharts

forked from uCharts / uCharts 
加入 Gitee
与超过 1200万 开发者一起发现、参与优秀开源项目,私有仓库也完全免费 :)
免费加入
克隆/下载
README.md 13.59 KB
一键复制 编辑 原始数据 按行查看 历史

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

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

最近1个月更新

  • 2019.08.15 修复 仪表盘数据更新后不能从当前位置开始动画的bug。
  • 2019.08.15 修复 玫瑰图面积模式中百分比计算错误的bug。
  • 2019.08.14 修复 饼图类百分比计算精度导致小数位数增多,不显示图表的bug。
  • 2019.08.14 修复 柱状图数值差距比较大的情况下,小数值完全不显示柱子的bug。
  • 2019.08.14 修复 玫瑰图最大值最小值计算错误导致图表显示错误的bug。
  • 2019.08.13 【v1.8.5】
  • 2019.08.13 新增 词云图动画效果及点击事件。
  • 2019.08.13 新增 地图点击事件及tooltip。
  • 2019.08.11 新增 地图(体验版),图表类型map
  • 2019.08.10 【v1.8.4】
  • 2019.08.10 新增 opts.xAxis.boundaryGap 折线图、区域图起画点结束点方法:center为单元格中间起画,justify为0点起画即两端对齐
  • 2019.08.09 修复 百度小程序折线图混合图中的折线偶尔为线段的bug
  • 2019.08.09 修复 百度小程序Y轴及数据标签不显示的bug,修复百度小程序折线图偶尔为线段的bug
  • 2019.08.08 修复 支付宝小程序IDE不显示图表的bug,终于可以在支付宝IDE看到图表了哈
  • 2019.08.06 【v1.8.2】
  • 2019.08.06 调整 饼图类图表opts.disablePieStroke位置为各类型的扩展配置中,增加extra.pie.border、extra.pie.borderWidth、extra.pie.borderColor参数(v1.8.1前版本升级后需修改此类参数)
  • 2019.08.06 优化 漏斗图,增加漏斗图tooltip及数据标签。
  • 2019.08.05 新增 漏斗图(体验版),图表类型funnel
  • 2019.08.02 新增 词云图(体验版),图表类型word,支持横向normal横纵混排vertical,详见demo。
  • 2019.08.02 修复 圆弧进度图进度不正确的bug。感谢jusn详见
  • 2019.07.27 修复 雷达图在IOS下不显示区域的bug。
  • 2019.07.27 新增 opts.extra.radar.opacity参数,雷达图区域背景颜色透明度。
  • 2019.07.27 新增 直角坐标系图表MarkLine标记线功能,详见文档扩展配置。
  • 2019.07.27 优化 多处基本数据重复计算,提升整体性能。
  • 2019.07.26 修复 K线图average.show为false报错的bug。
  • 2019.07.26 修复 支付宝小程序平台单页多次调用图表,填充边距倍增的bug。
  • 2019.07.26 修复 饼图、圆环图、玫瑰图在dataLabel为false时,tooltip事件无法显示的bug。
  • 2019.07.26 增加 饼图、圆环图、玫瑰图的 activeRadius 属性。
  • 2019.07.25 修复 ToolTip在点击相对画布底部的情况下超出画布显示不完整的bug。
  • 2019.07.25 修复 多行图例点击获取索引错误的bug。
  • 2019.07.25 修复 更新图表数据时padding、Y轴标签、图例等其他基础数据未同步更新的bug。
  • 2019.07.25 调整 padding及chartData挂载到opts,为后续性能提升做准备,格式化整体代码格式。
  • 2019.07.23 修复 X轴Y轴网格、辅助线为线段时,线段偶尔重叠的bug。
  • 2019.07.23 新增 opts.seriesMA,数据格式同opts.series, K线图自定义折线数据列表,内容同series,仅在opts.extra.candle.average.show为false时调用此数据,(默认调用此数据)。
  • 2019.07.22 修改 tooltip水平标签逻辑。
  • 2019.07.22 修复 K线图X轴Y轴标签在IOS下背景框显示不完整的bug。
  • 2019.07.21 【v1.8.0】
  • 2019.07.21 新增 【重要】图例位置自定义及图例点击事件,修复直角坐标系中绘图不精确的问题,修复饼图类半径计算问题,修复一些已知bug。如需稳定版,请用码云地址uCharts v1.7.0
  • 2019.07.19 新增 opts.colors 图表配色方案,不传则使用系统默认配置。
  • 2019.07.14 新增 opts.area 图表主区域配置,为将来多Y轴、图例位置自定义做准备。
  • 2019.07.14 新增 opts.legend 图例设置,未来将支持上下左右布局图例,目前仍为底部图例。
  • 2019.07.14 新增 opts.padding Array 默认 [10, 10, 10, 10] 画布填充边距,顺序为上右下左,同css,但必须4位 。
  • 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方式普通引用。

uCharts 官方网站

https://www.ucharts.cn

码云 gitee 开源地址

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

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

在线文档(备用地址)

QQ交流群:371774600

口令【gitee

快速体验

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

更新记录

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

  • 2019.08.xx 计划加入 条状图
  • 2019.08.xx 推迟计划加入 第二种仪表盘样式,增加《亲手教您如何改造 uCharts,打造您的专属图表》教程。
  • 2019.08.xx 计划加入 渐变颜色填充 功能,支持柱状图、区域图、混合图、圆弧进度条
  • 2019.08.xx 计划修复折线图样式为曲线时,个别情况下曲线超出 X 轴的问题。
  • 2019.08.xx 计划增加XY轴线配置。
  • 2019.08.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(面积模式、半径模式)
  • 词云图 word(横向、横纵混排)
  • 漏斗图 funnel
  • 地图 map
  • 条状图 bar(开发中)

插件特点

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

为何不用 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标签定义width、height和style属性来控制canvas的缩放来达到匹配高分屏,具体逻辑为width、height的数值应为图表根据pixelRatio的比例放大后的尺寸,而style的尺寸为屏幕的宽和高(并非真实物理像素点)例如:
width="750" height="500" style="width:750rpx;height:500rpx;"。
JavaScript
1
https://gitee.com/alanquain/uCharts.git
git@gitee.com:alanquain/uCharts.git
alanquain
uCharts
uCharts
master

搜索帮助