wx-f2

F2 for weixin mini-program

Usage no npm install needed!

<script type="module">
  import wxF2 from 'https://cdn.skypack.dev/wx-f2';
</script>

README

F2 微信小程序

F2 的微信小程序版本,支持原生 F2 的所有功能,欢迎使用反馈。

快速体验

  • 微信扫码体验

  • 使用微信开发者工具打开此项

说明

为了方便使用,我们封装了微信小程序的自定义组件,故需要微信小程序支持使用 npm 安装第三包。
重要:版本要求

  1. 小程序基础库版本 2.7.0 或以上
  2. 开发者工具 1.02.1808300 或以上开始,小程序支持使用 npm 安装第三方包。

如何使用

1. 安装依赖

项目默认初始化出来的是没有package.json的,需要新增package.json后再安装

## 没有package.json时执行下面这段
## echo "{}" > package.json

npm install @antv/wx-f2 --save

安装好依赖包之后,点击工具顶部菜单栏的详情:

勾选“使用 npm 模块”选项:

最后点击开发者工具中的菜单栏:工具 --> 构建 npm 即可运行。

如果碰到 @babel/runtime 未找到npm包入口文件,直接忽略就行了,不影响使用(强迫症碍眼的话,手动删除node_modules/@babel/runtime目录)

rm -rf node_modules/@babel/runtime

2. 使用自定义组件

1. 打开json文件,引入组件

{
  "usingComponents": {
    "f2": "@antv/wx-f2"
  }
}

2. wxml 使用组件

 <f2 class="f2" data="{{data}}" bind:draw="draw" />

3. wxss 设置宽高

.f2 {
  width: 100%;
  height: 500rpx;
}

4. 实例化图表

Page({
  data: {
    data:[
      { value: 123, type: '运行指数', date: '10/01' },
      { value: 62, type: '历史均值', date: '10/01' },
      { value: 212, type: '运行指数', date: '10/02' },
      { value: 59, type: '历史均值', date: '10/02' },
      { value: 53, type: '运行指数', date: '10/03' },
      { value: 210, type: '历史均值', date: '10/03' },
      { value: 162, type: '运行指数', date: '10/04' },
      { value: 1, type: '历史均值', date: '10/04' }
    ]
  },
  draw ({ detail: { chart, data } }) {
    chart.source(data, {
      date: {
        range: [0.05, 0.95]
      }
    })
    chart.legend('type', {
      align: 'right',
      itemWidth: 80
    })
    chart.line().shape('smooth').position('date*value').color('type', ['#de5341', '#4a81ed'])
    chart.area().shape('smooth').position('date*value')
      .color('type', ['l(90) 0:#de5341 1:#ffffff', 'l(90) 0:#4a81ed 1:#ffffff'])

    // 无需render
  }
});

组件 API

Props

|参数|说明|类型|默认值| |:-|:-|:-|:-| |data|数据源(修改data会自动更新图表)|Array|[]| |padding|图表绘图区域和画布边框的间距|String/Number/Array|"auto"| |append-padding|图表画布区域四边的预留边距|Number/Array|0|

Events

|事件名|说明| |:-|:-| |init|F2初始化| |draw|chart绘制| |reload|chart绘制完成| |update|数据更新|

f2 API

如何贡献

如果您在使用的过程中碰到问题,可以先通过 issues 看看有没有类似的 bug 或者建议。

License

MIT license