一、介紹

mpvue-vant記錄了我們團隊開發中在mpvue中使用Vant Weapp組件庫所踩下的坑，在這里分享給大家，讓mpvue開發者可以使用vant組件庫進行開發，避免踩不必要的坑。

此教程是在dov-yih一同協助下完成。經過測試，Vant Weapp下所有組件都能夠在mpvue中使用

mpvue-vant Github地址

二、使用方法

目前vant已經支持了npm的方式，但是由于node_modules目錄下的代碼是不會被編進dist目錄下的，所以暫時只能用git方式使用。

克隆vant倉庫

將dist目錄下的所有文件復制到你項目的/static/vant/目錄下。

git clone https://github.com/youzan/vant-weapp.git

// 當然你也可以克隆本倉庫代碼，本倉庫會與`vant`倉庫保持同步。直接將`vant`目錄復制到`/static`目錄下git clone https://github.com/Rychou/mpvue-vant.git

引入

在需要引入的頁面目錄下的main.json文件中

{ "usingComponents": {  "van-button": "/static/vant/button/index", }}

使用

<van-button>測試</van-button>

三、注意事項

具體組件 api 文檔參考Vant Weapp

1. 使用方式

mpvue 和原生小程序的方式有所不同。可以參考mpvue文檔

1.1 數據綁定

原生小程序使用方式為

value="{{value}}"

mpvue 使用方式

v-bind:value="value"http://或者:value="value"

1.2 事件監聽

原生小程序使用方式

bind:click="onClick"

mpvue 使用方式

@click="onClick"

1.3 vue 中組件引入

vant中像notify這種操作反饋類的組件都有兩個引入，一是組件的引入，這個在main.json中引入；另一個是方法的引入，需要在vue文件中import引入，值得注意的是，這里的引入不能使用絕對路徑，可以用類似于這樣的相對路徑。

import Notify from '@/../static/notify/notify' //@是mpvue的一個別名，指向src目錄

1.4 獲取 event

值得注意的是，mpvue中獲取event值與原生小程序有所不同。舉例：

onChange(event){ // 獲取表單組件filed的值 console.log(event.mp.detail) // 注意加入mp}

2. BUG 及報錯處理方法

2.1 監聽名

mpvue 里面無法使用@click-icon這樣的監聽名,因此如果 API 文檔里面有出現這樣的監聽名，那么需要手動修改源代碼。

可以改成駝峰式的監聽名。

eg: 我在field組件中就遇到這個問題，我的做法是：

// static/vant/field/index.jsthis.$emit('click-icon');// 修改為:this.$emit('clickIcon');