新聞中心
- ECharts 圖表-beta
- 介紹
- 使用方法
- 1. 在項(xiàng)目中引用動(dòng)態(tài)庫(kù)
- 2. 在使用到圖表組件的頁面配置動(dòng)態(tài)庫(kù)
- 3. 編寫
*.swan文件
- 動(dòng)態(tài)庫(kù)屬性列表
- 兼容性說明
- 配置項(xiàng)
- ECharts API 在動(dòng)態(tài)庫(kù)中的對(duì)應(yīng)使用方法
- formatter 的回調(diào)函數(shù)形式
ECharts 圖表-beta
介紹
ECharts 動(dòng)態(tài)庫(kù)是智能小程序基于 ECharts 實(shí)現(xiàn)的圖表動(dòng)態(tài)庫(kù),提供了圖表在小程序中的使用方法。如果在使用中碰到問題,可以在 Github 提問。

大安市網(wǎng)站制作公司哪家好,找成都創(chuàng)新互聯(lián)!從網(wǎng)頁設(shè)計(jì)、網(wǎng)站建設(shè)、微信開發(fā)、APP開發(fā)、成都響應(yīng)式網(wǎng)站建設(shè)公司等網(wǎng)站項(xiàng)目制作,到程序開發(fā),運(yùn)營(yíng)維護(hù)。成都創(chuàng)新互聯(lián)2013年開創(chuàng)至今到現(xiàn)在10年的時(shí)間,我們擁有了豐富的建站經(jīng)驗(yàn)和運(yùn)維經(jīng)驗(yàn),來保證我們的工作的順利進(jìn)行。專注于網(wǎng)站建設(shè)就選成都創(chuàng)新互聯(lián)。
完整的示例程序參見:demo 。
使用方法
1. 在項(xiàng)目中引用動(dòng)態(tài)庫(kù)
參考使用動(dòng)態(tài)庫(kù)中提供的方法,在app.json中增添一項(xiàng)dynamicLib,與pages同級(jí)。
- JSON
"dynamicLib": {"echartsLib": {"provider": "echarts_4_7_0"}},
目前支持的版本:echarts_4_7_0、echarts_4_4_0,分別對(duì)應(yīng) ECharts 4.7.0 及 4.4.0 版本,建議使用較新的echarts_4_7_0版本。
2. 在使用到圖表組件的頁面配置動(dòng)態(tài)庫(kù)
在每個(gè)使用到圖表組件的頁面,配置*.json文件如:
- JSON
{"usingSwanComponents": {"chart": "dynamicLib://echartsLib/chart"}}
3. 編寫 *.swan 文件
- SWAN
這是一種最基本的配置方式。
style也可以在*.css中聲明,需要保證是有寬度和高度的。option在*.js中綁定到頁面的 data 中。JS
const option = ...;Page({data: {option: option}});
其中,option 是一個(gè)圖表配置項(xiàng),定義了圖表的內(nèi)容和樣式。由于本圖表組件使用了 ECharts 作為底層實(shí)現(xiàn),所以這個(gè) option 就對(duì)應(yīng) ECharts 的配置項(xiàng)。一個(gè)簡(jiǎn)單的折線圖的配置項(xiàng)可能是這樣的——
- JS
option = {xAxis: {type: 'category',data: ['Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat', 'Sun']},yAxis: {type: 'value'},series: [{data: [820, 932, 901, 934, 1290, 1330, 1320],type: 'line'}]};
如果你不知道如何編寫配置項(xiàng),可以在 Echarts 官網(wǎng)或 Echarts 社區(qū)找到相似的例子,結(jié)合 Echarts 配置項(xiàng)文檔模仿修改。
動(dòng)態(tài)庫(kù)屬性列表
上支持的屬性包括:
| 屬性名稱 | 類型 | 說明 |
|---|---|---|
| option | Object | 配置項(xiàng),參見 ECharts 配置項(xiàng)文檔 |
| width | Number、String | 可顯式指定實(shí)例寬度(單位:像素)。如果傳入值為null/undefined/‘a(chǎn)uto’,則表示自動(dòng)取實(shí)例容器的寬度,參見 echarts.init |
| height | Number、String | 可顯式指定實(shí)例高度(單位:像素)。如果傳入值為null/undefined/‘a(chǎn)uto’,則表示自動(dòng)取實(shí)例容器的高度,參見 echarts.init |
| dpr | Number | 設(shè)備像素比,默認(rèn)取swan.getSystemInfoSync().pixelRatio,參見 echarts.init |
| notMerge | Boolean | 在更新配置項(xiàng)的時(shí)候,是否不跟之前設(shè)置的 option 合并,參見 echartsInstance.setOption |
| maps | Object、Array. | 如果是Object類型,則是包含name(地圖名稱,相當(dāng)于 echarts.registerMap 接口中的mapName)與geoJson( GeoJson 格式的數(shù)據(jù))的對(duì)象;如果是數(shù)組,則每一項(xiàng)都是包含name和geoJson的數(shù)組。具體的使用方法參見「地圖」的例子 |
| action | String | 需要觸發(fā)事件的時(shí)候,將這一屬性設(shè)為 ECharts 支持的屬性名稱,參見“事件觸發(fā)與監(jiān)聽”的例子 |
| toClear | Boolean | 設(shè)為true時(shí),相當(dāng)于調(diào)用 echartsInstance.clear,清空當(dāng)前實(shí)例,會(huì)移除實(shí)例中所有的組件和圖表 |
| extensions | Array. | ECharts 擴(kuò)展名稱,目前只支持字符云(‘wordcloud’)與水球圖(‘liquidfill’),注意都是小寫。使用方法參見「字符云」和「水球圖」的例子 |
兼容性說明
以下說明 ECharts 的配置項(xiàng)和 API 與本動(dòng)態(tài)庫(kù)的差別。
配置項(xiàng)
本動(dòng)態(tài)庫(kù)支持絕大部分的 ECharts 配置,已知不支持的配置項(xiàng)包括:
- toolbox.feature.dataView
ECharts API 在動(dòng)態(tài)庫(kù)中的對(duì)應(yīng)使用方法
ECharts 的 API 通過其他方式提供,開發(fā)者不能直接訪問到全局變量echarts和圖表實(shí)例。以下具體說明在 ECharts 的 API 在本動(dòng)態(tài)庫(kù)中對(duì)應(yīng)的用法。
formatter 的回調(diào)函數(shù)形式
由于無法向動(dòng)態(tài)庫(kù)傳遞function,因此不能直接使用 ECharts 中回調(diào)形式的formatter(如option.tooltip.formatter)。所以,從echarts_4_7_0版本開始,我們提供了字符串模板以解決這個(gè)問題。
例子參見「定制 formatter」,字符串模板參數(shù)是${params},模板語法詳見 etpl 模板語法。
該方法對(duì)于配置項(xiàng)中所有層級(jí)的formatter有效,對(duì)于其他名稱的回調(diào)函數(shù)無效。
全局方法
| 方法 | 說明 |
|---|---|
| echarts.init | 開發(fā)者無需手動(dòng)調(diào)用此方法,圖表會(huì)在 DOM 節(jié)點(diǎn) attach 的時(shí)候自動(dòng)初始化圖表。如果希望延遲初始化,參見「延遲加載圖表」的例子。默認(rèn)會(huì)采用 DOM 容器的大小作為圖表大小,如果需要強(qiáng)制指定大小,可以通過width和height屬性傳遞,參見「改變圖表容器大小」的例子 |
| echarts.connect | 不支持圖表聯(lián)動(dòng) |
| echarts.disconnect | 不支持圖表聯(lián)動(dòng) |
| echarts.dispose | 開發(fā)者無需手動(dòng)調(diào)用此方法,圖表會(huì)在圖表容器 DOM 被移除的時(shí)候自動(dòng)調(diào)用這個(gè)方法 |
| echarts.getInstanceByDom | 開發(fā)者無法訪問到容器上的實(shí)例,需要通過屬性的方式對(duì)圖表進(jìn)行操作 |
| echarts.registerMap | 在動(dòng)態(tài)組件中,通過maps屬性注冊(cè)地圖,具體方法參見「地圖」的例子 |
| echarts.getMap | 在動(dòng)態(tài)組件中,如果需要獲取此信息,請(qǐng)自行保存相關(guān)地圖信息 |
| echarts.registerTheme | 不支持注冊(cè)主題,請(qǐng)?zhí)峁┡渲庙?xiàng)改變樣式 |
| echarts.graphic | 不支持圖形相關(guān)幫助方法 |
實(shí)例方法
| 方法 | 說明 |
|---|---|
| echartsInstance.group | 不支持圖表聯(lián)動(dòng) |
| echartsInstance.setOption | 修改option屬性就相當(dāng)于調(diào)用該方法,參數(shù)notMerge可以通過屬性notMerge設(shè)置 |
| echartsInstance.getWidth | 在動(dòng)態(tài)組件中,如果需要獲取此信息,請(qǐng)自行保存寬度信息 |
| echartsInstance.getHeight | 在動(dòng)態(tài)組件中,如果需要獲取此信息,請(qǐng)自行保存高度信息 |
| echartsInstance.getDom | 不支持 DOM 操作 |
| echartsInstance.getOption | 在動(dòng)態(tài)組件中,如果需要獲取此信息,請(qǐng)自行保存配置項(xiàng)信息 |
| echartsInstance.resize | 通過修改width或height屬性實(shí)現(xiàn)該方法的調(diào)用,參見「改變圖表容器大小」的例子 |
| echartsInstance.dispatchAction | 通過修改action屬性實(shí)現(xiàn)該方法的調(diào)用,參見「事件觸發(fā)與監(jiān)聽」的例子 |
| echartsInstance.on | 通過bindxxx屬性(其中xxx是 ECharts 事件的名稱,注意都是小寫)實(shí)現(xiàn)該方法的調(diào)用,參見「事件觸發(fā)與監(jiān)聽」的例子。支持絕大部分 ECharts 的事件,不支持的包括:dbclick、mousemove、mouseover、mouseout、globalout、contextmenu |
| echartsInstance.off | 去除bindxxx屬性即可 |
| echartsInstance.convertToPixel | 不支持 |
| echartsInstance.convertFromPixel | 不支持 |
| echartsInstance.containPixel | 不支持 |
| echartsInstance.showLoading | 不支持 |
| echartsInstance.hideLoading | 不支持 |
| echartsInstance.getDataURL | 不支持 |
| echartsInstance.getConnectedDataURL | 不支持 |
| echartsInstance.appendData | 不支持 |
| echartsInstance.clear | 通過將toClear屬性設(shè)為true實(shí)現(xiàn) |
| echartsInstance.isDisposed | 不支持 |
| echartsInstance.dispose | 開發(fā)者無需手動(dòng)調(diào)用此方法,圖表會(huì)在圖表容器 DOM 被移除的時(shí)候自動(dòng)調(diào)用這個(gè)方法 |
當(dāng)前題目:創(chuàng)新互聯(lián)百度小程序教程:ECharts 圖表-beta
文章出自:http://www.5511xx.com/article/coceihs.html
其他資訊
- SSL證書有哪些類型?怎么去選擇這些證書?-SSL知識(shí)
- app如何卸載干凈?(刪除軟件設(shè)置,卸載軟件時(shí)怎么把之前的軟件設(shè)置也卸載干凈)
- 創(chuàng)新互聯(lián)Python教程:python二進(jìn)制dat數(shù)據(jù)怎么轉(zhuǎn)成txt文本
- 解決SQL2023遠(yuǎn)程創(chuàng)建數(shù)據(jù)庫(kù)失敗的問題(sql2023遠(yuǎn)程創(chuàng)建數(shù)據(jù)庫(kù)失敗)
- win10顯示無法將父項(xiàng)重定向到子項(xiàng)?(windows10重定向怎么用)


咨詢
建站咨詢
