微信小程序代碼由哪些文件構(gòu)成

這篇文章主要介紹了微信小程序代碼由哪些文件構(gòu)成，具有一定借鑒價(jià)值，感興趣的朋友可以參考下，希望大家閱讀完這篇文章之后大有收獲，下面讓小編帶著大家一起了解一下。

微信小程序代碼由以下四類文件構(gòu)成：

1. .json 后綴的 JSON 配置文件

2. .wxml 后綴的 WXML 模板文件

3. wxss 后綴的 WXSS 樣式文件

4. .js 后綴的 JS 腳本邏輯文件

一、JSON 配置

我們可以看到在項(xiàng)目的根目錄有一個(gè) app.json 和 project.config.json，此外在 pages/logs 目錄下還有一個(gè) logs.json，我們依次來(lái)說(shuō)明一下他們的用途。

小程序配置 app.json

app.json 是對(duì)當(dāng)前小程序的全局配置，包括了小程序的所有頁(yè)面路徑、界面表現(xiàn)、網(wǎng)絡(luò)超時(shí)時(shí)間、底部 tab 等。QuickStart 項(xiàng)目里邊的 app.json 配置內(nèi)容如下：

{
  "pages":[
    "pages/index/index",
    "pages/logs/logs"
  ],
  "window":{
    "backgroundTextStyle":"light",
    "navigationBarBackgroundColor": "#fff",
    "navigationBarTitleText": "WeChat",
    "navigationBarTextStyle":"black"
  }
}

我們簡(jiǎn)單說(shuō)一下這個(gè)配置各個(gè)項(xiàng)的含義:

1. pages字段 —— 用于描述當(dāng)前小程序所有頁(yè)面路徑，這是為了讓微信客戶端知道當(dāng)前你的小程序頁(yè)面定義在哪個(gè)目錄。

2. window字段 —— 小程序所有頁(yè)面的頂部背景顏色，文字顏色定義在這里的。

工具配置 project.config.json

通常大家在使用一個(gè)工具的時(shí)候，都會(huì)針對(duì)各自喜好做一些個(gè)性化配置，例如界面顏色、編譯配置等等，當(dāng)你換了另外一臺(tái)電腦重新安裝工具的時(shí)候，你還要重新配置。

考慮到這點(diǎn)，小程序開(kāi)發(fā)者工具在每個(gè)項(xiàng)目的根目錄都會(huì)生成一個(gè) project.config.json，你在工具上做的任何配置都會(huì)寫(xiě)入到這個(gè)文件，當(dāng)你重新安裝工具或者換電腦工作時(shí)，你只要載入同一個(gè)項(xiàng)目的代碼包，開(kāi)發(fā)者工具就自動(dòng)會(huì)幫你恢復(fù)到當(dāng)時(shí)你開(kāi)發(fā)項(xiàng)目時(shí)的個(gè)性化配置，其中會(huì)包括編輯器的顏色、代碼上傳時(shí)自動(dòng)壓縮等等一系列選項(xiàng)。

頁(yè)面配置 page.json

這里的 page.json 其實(shí)用來(lái)表示 pages/logs 目錄下的 logs.json 這類和小程序頁(yè)面相關(guān)的配置。

如果你整個(gè)小程序的風(fēng)格是藍(lán)色調(diào)，那么你可以在 app.json 里邊聲明頂部顏色是藍(lán)色即可。實(shí)際情況可能不是這樣，可能你小程序里邊的每個(gè)頁(yè)面都有不一樣的色調(diào)來(lái)區(qū)分不同功能模塊，因此我們提供了 page.json，讓開(kāi)發(fā)者可以獨(dú)立定義每個(gè)頁(yè)面的一些屬性，例如剛剛說(shuō)的頂部顏色、是否允許下拉刷新等等。

配置細(xì)節(jié)

app.json文件用來(lái)對(duì)微信小程序進(jìn)行全局配置，決定頁(yè)面文件的路徑、窗口表現(xiàn)、設(shè)置網(wǎng)絡(luò)超時(shí)時(shí)間、設(shè)置多 tab 等。

以下是一個(gè)包含了所有配置選項(xiàng)的 app.json ：

{
  "pages": [
    "pages/index/index",
    "pages/logs/index"
  ],
  "window": {
    "navigationBarTitleText": "Demo"
  },
  "tabBar": {
    "list": [{
      "pagePath": "pages/index/index",
      "text": "首頁(yè)"
    }, {
      "pagePath": "pages/logs/logs",
      "text": "日志"
    }]
  },
  "networkTimeout": {
    "request": 10000,
    "downloadFile": 10000
  },
  "debug": true
}

app.json 配置項(xiàng)列表

pages

接受一個(gè)數(shù)組，每一項(xiàng)都是字符串，來(lái)指定小程序由哪些頁(yè)面組成。每一項(xiàng)代表對(duì)應(yīng)頁(yè)面的【路徑+文件名】信息，數(shù)組的第一項(xiàng)代表小程序的初始頁(yè)面。小程序中新增/減少頁(yè)面，都需要對(duì) pages 數(shù)組進(jìn)行修改。

文件名不需要寫(xiě)文件后綴，因?yàn)榭蚣軙?huì)自動(dòng)去尋找路徑下 .json, .js, .wxml, .wxss 四個(gè)文件進(jìn)行整合。

如開(kāi)發(fā)目錄為：

pages/

pages/index/index.wxml

pages/index/index.js

pages/index/index.wxss

pages/logs/logs.wxml

pages/logs/logs.js

app.js

app.json

app.wxss

則需要在 app.json 中寫(xiě)

{
  "pages":[
    "pages/index/index",
    "pages/logs/logs"
  ]
}

window

用于設(shè)置小程序的狀態(tài)欄、導(dǎo)航條、標(biāo)題、窗口背景色。

注：HexColor（十六進(jìn)制顏色值），如"#ff00ff"

注：navigationStyle 只在 app.json 中生效。開(kāi)啟 custom 后，低版本客戶端需要做好兼容。開(kāi)發(fā)者工具基礎(chǔ)庫(kù)版本切到 1.7.0（不代表最低版本，只供調(diào)試用） 可方便切到舊視覺(jué)

如 app.json ：

{
  "window":{
    "navigationBarBackgroundColor": "#ffffff",
    "navigationBarTextStyle": "black",
    "navigationBarTitleText": "微信接口功能演示",
    "backgroundColor": "#eeeeee",
    "backgroundTextStyle": "light"
  }
}

tabBar

如果小程序是一個(gè)多 tab 應(yīng)用（客戶端窗口的底部或頂部有 tab 欄可以切換頁(yè)面），可以通過(guò) tabBar 配置項(xiàng)指定 tab 欄的表現(xiàn)，以及 tab 切換時(shí)顯示的對(duì)應(yīng)頁(yè)面。

Tip：

1. 當(dāng)設(shè)置 position 為 top 時(shí)，將不會(huì)顯示 icon

2. tabBar 中的 list 是一個(gè)數(shù)組，只能配置最少2個(gè)、最多5個(gè) tab，tab 按數(shù)組的順序排序。

屬性說(shuō)明：

其中 list 接受一個(gè)數(shù)組，數(shù)組中的每個(gè)項(xiàng)都是一個(gè)對(duì)象，其屬性值如下：

networkTimeout

可以設(shè)置各種網(wǎng)絡(luò)請(qǐng)求的超時(shí)時(shí)間。

屬性說(shuō)明：

debug

可以在開(kāi)發(fā)者工具中開(kāi)啟 debug 模式，在開(kāi)發(fā)者工具的控制臺(tái)面板，調(diào)試信息以 info 的形式給出，其信息有Page的注冊(cè)，頁(yè)面路由，數(shù)據(jù)更新，事件觸發(fā) 。 可以幫助開(kāi)發(fā)者快速定位一些常見(jiàn)的問(wèn)題。

page.json

每一個(gè)小程序頁(yè)面也可以使用.json文件來(lái)對(duì)本頁(yè)面的窗口表現(xiàn)進(jìn)行配置。 頁(yè)面的配置比app.json全局配置簡(jiǎn)單得多，只是設(shè)置 app.json 中的 window 配置項(xiàng)的內(nèi)容，頁(yè)面中配置項(xiàng)會(huì)覆蓋 app.json 的 window 中相同的配置項(xiàng)。

頁(yè)面的.json只能設(shè)置 window 相關(guān)的配置項(xiàng)，以決定本頁(yè)面的窗口表現(xiàn)，所以無(wú)需寫(xiě) window 這個(gè)鍵，如：

{
  "navigationBarBackgroundColor": "#ffffff",
  "navigationBarTextStyle": "black",
  "navigationBarTitleText": "微信接口功能演示",
  "backgroundColor": "#eeeeee",
  "backgroundTextStyle": "light"
}

感謝你能夠認(rèn)真閱讀完這篇文章，希望小編分享的“微信小程序代碼由哪些文件構(gòu)成”這篇文章對(duì)大家有幫助，同時(shí)也希望大家多多支持億速云，關(guān)注億速云行業(yè)資訊頻道，更多相關(guān)知識(shí)等著你來(lái)學(xué)習(xí)!