W3Cschool
恭喜您成為首批注冊(cè)用戶
獲得88經(jīng)驗(yàn)值獎(jiǎng)勵(lì)
感謝你使用 Vant。
以下是關(guān)于向 Vant 提交反饋或代碼的指南。在向 Vant 提交 issue 或者 PR 之前,請(qǐng)先花幾分鐘時(shí)間閱讀以下內(nèi)容。
在進(jìn)行本地開發(fā)前,請(qǐng)先確保你的開發(fā)環(huán)境中安裝了 Node.js >= 14.19.0。
按照下面的步驟操作,即可在本地開發(fā) Vant 組件。
# 克隆倉(cāng)庫(kù)
git clone git@github.com:vant-ui/vant.git
# 啟用 pnpm 包管理器
corepack enable
# 如果無法使用 corepack,你也可以手動(dòng)安裝 pnpm
npm install -g pnpm@7
# 安裝依賴
pnpm i
# 進(jìn)入開發(fā)模式,瀏覽器訪問 localhost
pnpm dev
倉(cāng)庫(kù)的不同分支對(duì)應(yīng)不同的 Vant 版本,請(qǐng)切換到對(duì)應(yīng)分支進(jìn)行開發(fā):
如果 GitHub 克隆速度較慢,你也可以直接克隆 Vant 在 gitee 上的鏡像倉(cāng)庫(kù):
git clone git@gitee.com:vant-contrib/vant.git
鏡像倉(cāng)庫(kù)僅用于加快國(guó)內(nèi)的訪問速度,請(qǐng)勿在鏡像倉(cāng)庫(kù)中提 issue 和 Pull Request。
Vant 采用 monorepo 進(jìn)行代碼管理,所有子包在 ?packages
? 目錄下:
root
└─ packages
├─ vant # 組件庫(kù)
├─ vant-cli # 腳手架
├─ vant-icons # 圖標(biāo)庫(kù)
├─ vant-use # Composition API
└─ .... # 其他周邊 npm 包
其中,?vant
? 目錄為組件庫(kù)的核心代碼:
vant
├─ docs # 文檔
├─ src # 組件源代碼
├─ test # 單測(cè)工具類
└─ vant.config.mjs # 文檔網(wǎng)站配置
?src
? 目錄包含各個(gè)組件的源碼,每個(gè)文件夾對(duì)應(yīng)一個(gè)組件:
src
└─ button
├─ demo # 示例代碼
├─ test # 單元測(cè)試
├─ Component.tsx # 組件
├─ index.ts # 組件入口
├─ index.less # 樣式
├─ var.less # 樣式變量
├─ README.md # 英文文檔
└─ README.zh-CN.md # 中文文檔
在編寫代碼時(shí),請(qǐng)注意:
async/await
?。如果你是第一次在 GitHub 上提 Pull Request ,可以閱讀下面這兩篇文章來學(xué)習(xí):
在提交 Pull Request 時(shí),請(qǐng)注意:
提 Pull Request 前,請(qǐng)依照下面的流程同步主倉(cāng)庫(kù)的最新代碼:
# 添加主倉(cāng)庫(kù)到 remote,作為 fork 后倉(cāng)庫(kù)的上游倉(cāng)庫(kù)
git remote add upstream git@github.com:vant-ui/vant.git
# 拉取主倉(cāng)庫(kù)最新代碼
git fetch upstream
# 切換至 dev 分支
git checkout dev
# 合并主倉(cāng)庫(kù)代碼
git merge upstream/dev
Copyright©2021 w3cschool編程獅|閩ICP備15016281號(hào)-3|閩公網(wǎng)安備35020302033924號(hào)
違法和不良信息舉報(bào)電話:173-0602-2364|舉報(bào)郵箱:jubao@eeedong.com
掃描二維碼
下載編程獅App
編程獅公眾號(hào)
聯(lián)系方式:
更多建議: