在微信小程序中使用
本項目是 的 Mpvue 小程序版本。開發者可以通過熟悉的 配置方式及 Vue 語法,快速開發圖表,滿足各種可視化需求。
掃碼體驗
安裝
npm i mpvue-echarts
使用
<script>
import echarts from 'echarts'
import mpvueEcharts from 'mpvue-echarts'
let chart = null;

function initChart(canvas, width, height) {
chart = echarts.init(canvas, null, {
width: width,
height: height
});
canvas.setChart(chart);
var option = {}; // ECharts 配置項
chart.setOption(option);
return chart; // 返回 chart 后可以自動綁定觸摸操作
}
export default {
components: {
mpvueEcharts
},
data () {
return {
echarts,

onInit: initChart
}
}
}
</script>
這對于所有 圖表都是通用的,用戶只需要修改上面 的內容,即可改變圖表。 的使用方法參見 配置項文檔。對于不熟悉 的用戶,可以參見 教程。
屬性名稱類型默認值描述
null
對象
ec-
null
初始化函數
false
懶加載
false
禁用觸摸事件
false
節流觸摸事件
FAQ[重要] 不要把 chart 實例賦值到 this(vue 實例) 上如何獲取圖表實例?
.init 返回的即為圖表實例。
打包結果超過小程序大小限制?
使用自定義版小程序圖片懶加載,官網定制
如何延遲加載圖表?
參見 / 的例子,可以在獲取數據后再初始化數據。
如何在一個頁面中加載多個圖表?
參見 / 的例子。
圖表變空白?
嘗試設置 屬性為 true。
如何使用 ?
目前,本項目已支持 ,但是由于 相關功能尚未發版,因此當前需要使用原項目中 ec-/.js,這個文件包含了可以在微信中使用 的相關代碼。目前在 官網下載的 .js 還不能直接替換使用,等 正式發版后即可。
具體使用方法和 相同,例子參見 pages/line/index.js。
文件太大怎么辦?
本項目默認提供的 文件是最新版本的包含所有組件文件,為了便于開發,提供的是未壓縮的版本。遠程調試或預覽可以下載 .min.js 壓縮版本。
發布時,如果對文件大小要求更高,可以在 在線定制網頁下載僅包含必要組件的包,并且選擇壓縮。
打包時出錯 ERROR in /js/.js from
參照以下配置使 babel 處理 mpvue-
// webpack.base.conf.js
{
test: /\.js$/,
include: [
resolve('src'),

resolve('node_modules/mpvue-echarts')
],
use: [
'babel-loader',
{
loader: 'mpvue-loader',
options: {
checkMPEntry: true
}
}
]
}
微信版本要求
支持微信版本 >= 6.6.3,對應基礎庫版本 >= 1.9.91。盡可能使用更高版本的基礎庫版本。
調試的時候,需要在微信開發者工具中小程序圖片懶加載,將“詳情”下的“調試基礎庫”設為 1.9.91 及以上版本。
發布前,需要在 的“設置”頁面,將“基礎庫最低版本設置”設為 1.9.91。當用戶微信版本過低的時候,會提示用戶更新。
暫不支持的功能
中的絕大部分功能都支持小程序版本,因此這里僅說明不支持的功能,以及存在的問題。
以下功能尚不支持,如果有相關需求請在 issue 中向我們反饋,對于反饋人數多的需求將優先支持:
此外,目前還有一些 bug 尚未修復,部分需要小程序團隊配合上線支持,但不影響基本的使用。已知的 bug 包括:
如有其它問題,也歡迎在 issue 中向我們反饋,謝謝!