以下是微信小程序中安裝 Vant 的詳細步驟:
1. 初始化項目
在微信小程序項目目錄下,打開終端,執行以下命令進行項目初始化:
npm init -y
該命令會快速生成一個默認的package.json
文件,-y
參數表示直接使用默認配置,無需手動輸入信息。
2. 安裝 Vant 相關依賴
繼續在項目目錄下的終端中,執行以下命令安裝 Vant Weapp:
npm i @vant/weapp -S --production
此命令會將 Vant Weapp 作為項目的生產依賴安裝到node_modules
目錄中。
3. 修改app.json
打開項目根目錄下的app.json
文件,找到并刪除其中的"style": "v2"
字段。因為小程序的新版基礎組件會強行加上許多樣式,難以覆蓋,不刪除可能會導致部分組件樣式混亂。
4. 修改project.config.json
由于微信開發者工具創建的項目中,miniprogramRoot
默認為miniprogram
,而package.json
在外部,導致 npm 構建無法正常工作。需要在project.config.json
文件中手動添加以下配置,以便開發者工具可以正確索引到 npm 依賴的位置:
"setting": {"packNpmManually": true,"packNpmRelationList": [{"packageJsonPath": "./package.json","miniprogramNpmDistDir": "./"}]
}
注意:對于新版開發者工具,miniprogramNpmDistDir
配置為"./"
即可。
5. 構建 npm
打開微信開發者工具,點擊“工具”->“構建 npm”,并勾選“使用 npm 模塊”選項。構建成功后,即可在項目中使用 Vant 組件。
6. 使用組件
全局引入
在app.json
中添加需要使用的組件路徑,例如:
"usingComponents": {"van-button": "@vant/weapp/button/index"
}
這樣,在任意頁面的wxml
文件中都可以直接使用van-button
組件。
局部引入
如果只想在某個頁面使用某個組件,可以在該頁面的json
文件中進行引入,例如:
{"usingComponents": {"van-slider": "@vant/weapp/slider/index"}
}
然后在該頁面的wxml
文件中使用van-slider
組件。
至此,Vant 組件庫就成功安裝并可以在微信小程序中使用了。