JSON 配置

JSON 是一(yī)種數(shù)據格式，并不是編程語言，在小程序中，JSON扮演的靜态配置的角色。

我們可(kě)以看(kàn)到在項目的根目錄有一(yī)個 app.json 和(hé) project.config.json，此外(wài)在 pages/logs 目錄下(xià)還有一(yī)個 logs.json，我們依次來說明(míng)一(yī)下(xià)它們的用途。

小程序配置 app.json

app.json 是當前小程序的全局配置，包括了(le)小程序的所有頁面路徑、界面表現、網絡超時(shí)時(shí)間(jiān)、底部 tab 等。QuickStart 項目裏邊的 app.json 配置內(nèi)容如(rú)下(xià)：

{

"pages":[

"pages/index/index",

"pages/logs/logs"

],

"window":{

"backgroundTextStyle":"light",

"navigationBarBackgroundColor": "#fff",

"navigationBarTitleText": "Weixin",

"navigationBarTextStyle":"black"

}

}

我們簡單說一(yī)下(xià)這(zhè)個配置各個項的含義:

pages字段 —— 用于描述當前小程序所有頁面路徑，這(zhè)是為(wèi)了(le)讓微(wēi)信客戶端知道(dào)當前你的小程序頁面定義在哪個目錄。

window字段 —— 定義小程序所有頁面的頂部背景顔色，文字顔色定義等。

其他(tā)配置項細節可(kě)以參考文檔 小程序的配置 app.json 。

工(gōng)具配置 project.config.json

通(tōng)常大家在使用一(yī)個工(gōng)具的時(shí)候，都(dōu)會針對各自(zì)喜好做(zuò)一(yī)些個性化配置，例如(rú)界面顔色、編譯配置等等，當你換了(le)另外(wài)一(yī)台電腦重新安裝工(gōng)具的時(shí)候，你還要(yào)重新配置。

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

其他(tā)配置項細節可(kě)以參考文檔 開(kāi)發者工(gōng)具的配置 。

頁面配置 page.json

這(zhè)裏的 page.json 其實用來表示 pages/logs 目錄下(xià)的 logs.json 這(zhè)類和(hé)小程序頁面相關的配置。

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

其他(tā)配置項細節可(kě)以參考文檔 頁面配置 。

JSON 語法

這(zhè)裏說一(yī)下(xià)小程序裏JSON配置的一(yī)些注意事項。

JSON文件都(dōu)是被包裹在一(yī)個大括号中 {}，通(tōng)過key-value的方式來表達數(shù)據。JSON的Key必須包裹在一(yī)個雙引号中，在實踐中，編寫 JSON 的時(shí)候，忘了(le)給 Key 值加雙引号或者是把雙引号寫成單引号是常見(jiàn)錯誤。

JSON的值隻能(néng)是以下(xià)幾種數(shù)據格式，其他(tā)任何格式都(dōu)會觸發報錯，例如(rú) JavaScript 中的 undefined。

數(shù)字，包含浮點數(shù)和(hé)整數(shù)

字符串，需要(yào)包裹在雙引号中

Bool值，true 或者 false

數(shù)組，需要(yào)包裹在方括号中 []

對象，需要(yào)包裹在大括号中 {}

Null

還需要(yào)注意的是 JSON 文件中無法使用注釋，試圖添加注釋将會引發報錯。