前端Uniapp使用Vant打造Uniapp項目避坑指南

更新時間：2024年11月12日 09:50:29 作者：Qianmo_er

這篇文章主要給大家介紹了關于前端Uniapp使用Vant打造Uniapp項目避坑的相關資料,Uniapp結合Vant可以快速構建跨平臺移動應用,通過HBuilderX安裝和配置Vant組件,解決了樣式識別問題,并實現了組件的全局注冊,需要的朋友可以參考下

1. HBuilder X中新建一個uni-app的項目
2. HBuilder X提示項目創(chuàng)建成功，在HBuilder X用命令行窗口打開創(chuàng)建的項目（或直接在創(chuàng)建的項目文件夾內用cmd指令打開）
3. 輸入npm init -y 指令，創(chuàng)建項目配置文件（即package.json）；
4. 輸入npm i @vant/weapp -S --production下載vant
5. 在項目的根路徑下，創(chuàng)建 wxcomponents 目錄，并將依賴項（node_modules）中@vant文件夾下的dist復制到wxcomponents，并修改文件夾名為vant;（主要是為了方便查看和引用）
6. 在pages.json中注冊并引入組件
7. 找到 App.vue ，引入公共組件樣式

總結

一、基本介紹

Uniapp 是基于 Vue.js 的開發(fā)框架，通過一套代碼可以同時發(fā)布到多個平臺的應用框架。而 Vant 是針對移動端 Vue.js 的組件庫。通過這樣的組合，我們可以快速構建出一個跨平臺的移動應用。Vant 已經支持多種小程序和 H5 平臺，也對 Uniapp 實現了完美的支持。我們可以使用 Vant 提供的豐富的組件和功能，來快速開發(fā)一個漂亮、易用的移動應用。

二、安裝 Vant 組件

1. HBuilder X中新建一個uni-app的項目

1、添加項目名稱，選擇文件路徑

2、選擇默認模板

3、Vue版本選擇（若無其他需求，點擊創(chuàng)建即可）

注意：

項目名不能有空格；不能出現開頭大寫；不能用中文命名

2. HBuilder X提示項目創(chuàng)建成功，在HBuilder X用命令行窗口打開創(chuàng)建的項目（或直接在創(chuàng)建的項目文件夾內用cmd指令打開）

3. 輸入npm init -y 指令，創(chuàng)建項目配置文件（即package.json）；

4. 輸入npm i @vant/weapp -S --production下載vant

安裝完成后，項目中會多出一個依賴項，也代表安裝成功

5. 在項目的根路徑下，創(chuàng)建 wxcomponents 目錄，并將依賴項（node_modules）中@vant文件夾下的dist復制到wxcomponents，并修改文件夾名為vant;（主要是為了方便查看和引用）

6. 在pages.json中注冊并引入組件

7. 找到 App.vue ，引入公共組件樣式

先運行一下：

報錯：

這是因為引入 vant 組件的時候識別樣式，vant-icon 發(fā)生了錯誤，改一下就可以。

這里發(fā)生錯誤的第一編號是 iv4v8nulyz.可以自己仔細看看，每個人會有不同，如果查找到的話
/vant/wxcomponents/vant/icon/index.wxss找到這個地方

然后再第二個和第三個URL前面加一個空格（英文狀態(tài)下），關掉刷新一下，再重新打開 Hbuild.

以下為組件的全局注冊，可根據需求按需導入組件：

"usingComponents": {
      "van-action-sheet": "/wxcomponents/vant/action-sheet/index",
      "van-area": "/wxcomponents/vant/area/index",
      "van-button": "/wxcomponents/vant/button/index",
      "van-card": "/wxcomponents/vant/card/index",
      "van-cell": "/wxcomponents/vant/cell/index",
      "van-cell-group": "/wxcomponents/vant/cell-group/index",
      "van-checkbox": "/wxcomponents/vant/checkbox/index",
      "van-checkbox-group": "/wxcomponents/vant/checkbox-group/index",
      "van-col": "/wxcomponents/vant/col/index",
      "van-dialog": "/wxcomponents/vant/dialog/index",
      "van-field": "/wxcomponents/vant/field/index",
      "van-goods-action": "/wxcomponents/vant/goods-action/index",
      "van-goods-action-icon": "/wxcomponents/vant/goods-action-icon/index",
      "van-goods-action-button": "/wxcomponents/vant/goods-action-button/index",
      "van-icon": "/wxcomponents/vant/icon/index",
      "van-loading": "/wxcomponents/vant/loading/index",
      "van-nav-bar": "/wxcomponents/vant/nav-bar/index",
      "van-notice-bar": "/wxcomponents/vant/notice-bar/index",
      "van-notify": "/wxcomponents/vant/notify/index",
      "van-panel": "/wxcomponents/vant/panel/index",
      "van-popup": "/wxcomponents/vant/popup/index",
      "van-progress": "/wxcomponents/vant/progress/index",
      "van-radio": "/wxcomponents/vant/radio/index",
      "van-radio-group": "/wxcomponents/vant/radio-group/index",
      "van-row": "/wxcomponents/vant/row/index",
      "van-search": "/wxcomponents/vant/search/index",
      "van-slider": "/wxcomponents/vant/slider/index",
      "van-stepper": "/wxcomponents/vant/stepper/index",
      "van-steps": "/wxcomponents/vant/steps/index",
      "van-submit-bar": "/wxcomponents/vant/submit-bar/index",
      "van-swipe-cell": "/wxcomponents/vant/swipe-cell/index",
      "van-switch": "/wxcomponents/vant/switch/index",
      "van-tab": "/wxcomponents/vant/tab/index",
      "van-tabs": "/wxcomponents/vant/tabs/index",
      "van-tabbar": "/wxcomponents/vant/tabbar/index",
      "van-tabbar-item": "/wxcomponents/vant/tabbar-item/index",
      "van-tag": "/wxcomponents/vant/tag/index",
      "van-toast": "/wxcomponents/vant/toast/index",
      "van-transition": "/wxcomponents/vant/transition/index",
      "van-tree-select": "/wxcomponents/vant/tree-select/index",
      "van-datetime-picker": "/wxcomponents/vant/datetime-picker/index",
      "van-rate": "/wxcomponents/vant/rate/index",
      "van-collapse": "/wxcomponents/vant/collapse/index",
      "van-collapse-item": "/wxcomponents/vant/collapse-item/index",
      "van-picker": "/wxcomponents/vant/picker/index"
    }

如此，即完成了Vant組件庫的引入！