文章详情

短信预约-IT技能 免费直播动态提醒

请输入下面的图形验证码

提交验证

短信预约提醒成功

原生微信小程序使用u-charts(组件版)折线图示例

2023-09-04 19:53

关注

一、写在前面

        之前一直使用的都是 wx-charts,链接: xiaolin3303/wx-charts: 微信小程序图表charts组件 ,但是这个库已经五六年没有维护了,经常出现 canvas层级过高弹窗无法覆盖等问题(微信小程序前面新推出了 canvas-2d,解决了这个问题)

        摸索了官网文档一个下午,今天来介绍以下 u-charts 的组件版的基本使用,官网 uCharts官网 - 秋云uCharts跨平台图表库,下面这些tab可能会帮助到你

 

二、下载组件

源码地址:uCharts: 高性能跨平台图表库 微信小程序 (gitee.com)

点进去找到 “微信小程序”

选择组件版 (原生版也可以,但是需要自己创造实例,比较麻烦,我折腾了几个小时后 换成了组件版发现快多了)

点进去,把src下的文件全部拷贝下来 (可以把整个仓库下载为zip,再找到这里面,就可以一键复制了)

 在微信小程序根目录下 新建一个文件夹 components

然后再在components下新建一个文件夹,取名 qiun-wx-ucharts

把上面src里面的所有文件,都复制粘贴到 qiun-wx-ucharts 里

 至此,就可以直接使用了

三、基本使用

在需要使用图表的页面(假设页面为 test.wxml )

1.test.json 引入组件

{  "usingComponents": {    "qiun-wx-ucharts": "/components/qiun-wx-ucharts/index"  }}

 2.test.wxml 放置组件

  

3.test.wxss 设置组件宽高

这是必须配置的css,组件会自动获取css的宽高,来给canvas设置宽度 (下面的 .table 是组件的父元素的类名)

  .table {    width: 100%;    height: 300px;  }

4.test.js 配置数据

折线的数据目前是写死的,你可以根据你的需要,去更新 this.data.chartData ,图表会自动重绘

// pages/chart/chart.jsPage({    data:{    chartData: {},//数据里包含了 categories x轴数组,series 需要绘制的曲线数组    opts: {//配置项,这里只展示了部分,关于配置项的详细解释可以到官网文档查看     color: ["#1890FF", "#91CB74"],     enableScroll: false,//是否开启滚动     dataLabel: false,     xAxis: {       disableGrid: true,//是否 不纵向绘制网格       type: 'grid',       gridType: 'dash',       scrollBackgroundColor: '#00000000',//默认为 #EFEBEF       scrollColor: '#DEE7F7',//默认为 #A6A6A6       rotateLabel: true,//开启文字旋转功能     },     yAxis: {       gridType: "dash",       dashLength: 2,     },     extra: {       line: {         type: "curve",         width: 2,         activeType: "hollow"       }     }   }, },    onLoad(options) {    let data = { // 数据里包含了 categories x轴数组,series 需要绘制的曲线数组      categories: ["2016","2017","2018","2019","2020","2021"],      series: [        {          name: "目标值",          data: [35,36,31,33,13,34]        },        {          name: "完成量",          data: [18,27,21,24,6,28]        }      ]    };    //只要给 chartData 修改了值,就会触发图表的重新绘制    this.setData({      chartData : JSON.parse(JSON.stringify(data)) //深拷贝数据,防止出现问题    })  },    onReady() {  },    onShow() {  },    onHide() {  },    onUnload() {  },    onPullDownRefresh() {  },    onReachBottom() {  },    onShareAppMessage() {  }})

5.效果示例

点击后可以查看数据点 

 

四、进阶用法

1.开启滚动

当数据量很多的时候,折线的点就会堆积在一起,很不美观

我们可以开启滚动模式,设置一屏幕展示多少个数据项,就可以更美观了

(1)在js文件的data中修改以下配置项:

 opts.enableScroll 改为 true,开启滚动模式 必须填写

opts.xAxis.itemCount 设置为“一屏幕想展示的数据量” Number 必须填写

(2)在wxml文件中

 给组件props新增一个 ontouch="true"  这一点官网文档没写明,我试了很久才发现要这个东西,才能滚动

(3)代码

js文件中修改opts:

//在上文js代码中,修改 data里的opts opts: {//配置项,这里只展示了部分,关于配置项的详细解释可以到官网文档查看      color: ["#1890FF", "#91CB74"],      enableScroll: true,//是否开启滚动 ————滚动需要的配置      xAxis: {        disableGrid: true,//是否 不纵向绘制网格        type: 'grid',        gridType: 'dash',        itemCount: 10,//x轴单屏显示数据的数量,默认为5个 ————滚动需要的配置        scrollBackgroundColor: '#00000000',//默认为 #EFEBEF        scrollColor: '#DEE7F7',//默认为 #A6A6A6        rotateLabel: true,//开启文字旋转功能      },      yAxis: {        gridType: "dash",        dashLength: 2,      },      extra: {        line: {          type: "curve",          width: 2,          activeType: "hollow"        }      }    },

wxml里新增一个props传递 ontouch 

  

效果

向右滑动 

关于滚动还有一些其他配置项,详情到官网文档查看

注意:开启滚动后,在微信小程序开发者工具观看会有异常,但是实际是没问题的,请扫码观看 

2.点击后获取数据索引 (获取当前点击的数据)

getIndex 官网文档

 

这个在官网文档的示例全是 uniapp 的,找不到微信小程序的,连问答区都没人问这个问题。

涉及知识点:给自定义组件传递自定义事件

上面文档中 @getIndex 这种有 @ 符的是uniapp的写法,在微信小程序中并不适合

然而又不想使用原生的创建实例的方法,只想用组件形式(我们现在讲的是组件方法,原生方法是 引入 u-charts.js 文件后,new一个uCharts实例出来操作,比较复杂)

其实很简单,给小程序自定义组件传递自定义事件,只需要 bind:xxx="xxxx"  

我们需要传递 getIndex 这个自定义事件,就写   bind:getIndex="touchcanvas" (其中touchcanvas是在当前页面绑定的函数,getIndex是自定义事件的名称)

  

然后在js文件里,写 touchcanvas 函数,通过e就能获取数据的索引号了

  //图表点击操作  touchcanvas(e) {    let index = e.detail.currentIndex.index //这个就是数组的索引        let arr = [         //....    ]; //假设这里面装了图表正在展示的数据    //就能通过 arr[index] 获取当前点击的数据    console.log(index, arr[index] )  },

五、最后

        这篇文章只讲述了折线图的基本使用方法,更多配置项建议阅读官方文档 (链接在文章开头)

        本文的第四点 进阶用法,是我的踩坑记录:1. 为什么设置了允许滚动,滑动页面没有效果?2.到底怎么获取索引号?为什么官网都是uniapp的演示,找不到我想要的内容

来源地址:https://blog.csdn.net/m0_64130892/article/details/129450721

阅读原文内容投诉

免责声明:

① 本站未注明“稿件来源”的信息均来自网络整理。其文字、图片和音视频稿件的所属权归原作者所有。本站收集整理出于非商业性的教育和科研之目的,并不意味着本站赞同其观点或证实其内容的真实性。仅作为临时的测试数据,供内部测试之用。本站并未授权任何人以任何方式主动获取本站任何信息。

② 本站未注明“稿件来源”的临时测试数据将在测试完成后最终做删除处理。有问题或投稿请发送至: 邮箱/279061341@qq.com QQ/279061341

软考中级精品资料免费领

  • 历年真题答案解析
  • 备考技巧名师总结
  • 高频考点精准押题
  • 2024年上半年信息系统项目管理师第二批次真题及答案解析(完整版)

    难度     807人已做
    查看
  • 【考后总结】2024年5月26日信息系统项目管理师第2批次考情分析

    难度     351人已做
    查看
  • 【考后总结】2024年5月25日信息系统项目管理师第1批次考情分析

    难度     314人已做
    查看
  • 2024年上半年软考高项第一、二批次真题考点汇总(完整版)

    难度     433人已做
    查看
  • 2024年上半年系统架构设计师考试综合知识真题

    难度     221人已做
    查看

相关文章

发现更多好内容

猜你喜欢

AI推送时光机
位置:首页-资讯-移动开发
咦!没有更多了?去看看其它编程学习网 内容吧
首页课程
资料下载
问答资讯