小程序代碼構(gòu)成
在上一章中，我們通過(guò)開發(fā)者工具快速創(chuàng)建了一個(gè) QuickStart 項(xiàng)目。你可以留意到這個(gè)項(xiàng)目里邊生成了不同類型的文件:
.json?后綴的?JSON?配置文件.wxml?后綴的?WXML?模板文件.wxss?后綴的?WXSS?樣式文件.js?后綴的?JS?腳本邏輯文件
接下來(lái)我們分別看看這4種文件的作用。
JSON 配置
JSON 是一種數(shù)據(jù)格式，并不是編程語(yǔ)言，在小程序中，JSON扮演的靜態(tài)配置的角色。
我們可以看到在項(xiàng)目的根目錄有一個(gè)?app.json?和?project.config.json，此外在?pages/logs?目錄下還有一個(gè)?logs.json，我們依次來(lái)說(shuō)明一下它們的用途。
小程序配置 app.json
app.json?是當(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":?"Weixin",
????"navigationBarTextStyle":"black"
??}}我們簡(jiǎn)單說(shuō)一下這個(gè)配置各個(gè)項(xiàng)的含義:
pages字段 —— 用于描述當(dāng)前小程序所有頁(yè)面路徑，這是為了讓微信客戶端知道當(dāng)前你的小程序頁(yè)面定義在哪個(gè)目錄。window字段 —— 定義小程序所有頁(yè)面的頂部背景顏色，文字顏色定義等。
其他配置項(xiàng)細(xì)節(jié)可以參考文檔?小程序的配置 app.json?。
工具配置 project.config.json
通常大家在使用一個(gè)工具的時(shí)候，都會(huì)針對(duì)各自喜好做一些個(gè)性化配置，例如界面顏色、編譯配置等等，當(dāng)你換了另外一臺(tái)電腦重新安裝工具的時(shí)候，你還要重新配置。
考慮到這點(diǎn)，小程序開發(fā)者工具在每個(gè)項(xiàng)目的根目錄都會(huì)生成一個(gè)?project.config.json，你在工具上做的任何配置都會(huì)寫入到這個(gè)文件，當(dāng)你重新安裝工具或者換電腦工作時(shí)，你只要載入同一個(gè)項(xiàng)目的代碼包，開發(fā)者工具就自動(dòng)會(huì)幫你恢復(fù)到當(dāng)時(shí)你開發(fā)項(xiàng)目時(shí)的個(gè)性化配置，其中會(huì)包括編輯器的顏色、代碼上傳時(shí)自動(dòng)壓縮等等一系列選項(xiàng)。
其他配置項(xiàng)細(xì)節(jié)可以參考文檔?開發(fā)者工具的配置?。
頁(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，讓開發(fā)者可以獨(dú)立定義每個(gè)頁(yè)面的一些屬性，例如剛剛說(shuō)的頂部顏色、是否允許下拉刷新等等。
其他配置項(xiàng)細(xì)節(jié)可以參考文檔?頁(yè)面配置?。
JSON 語(yǔ)法
這里說(shuō)一下小程序里JSON配置的一些注意事項(xiàng)。
JSON文件都是被包裹在一個(gè)大括號(hào)中 {}，通過(guò)key-value的方式來(lái)表達(dá)數(shù)據(jù)。JSON的Key必須包裹在一個(gè)雙引號(hào)中，在實(shí)踐中，編寫 JSON 的時(shí)候，忘了給 Key 值加雙引號(hào)或者是把雙引號(hào)寫成單引號(hào)是常見錯(cuò)誤。
JSON的值只能是以下幾種數(shù)據(jù)格式，其他任何格式都會(huì)觸發(fā)報(bào)錯(cuò)，例如 JavaScript 中的 undefined。
數(shù)字，包含浮點(diǎn)數(shù)和整數(shù)
字符串，需要包裹在雙引號(hào)中
Bool值，true 或者 false
數(shù)組，需要包裹在方括號(hào)中 []
對(duì)象，需要包裹在大括號(hào)中 {}
Null
還需要注意的是 JSON 文件中無(wú)法使用注釋，試圖添加注釋將會(huì)引發(fā)報(bào)錯(cuò)。
WXML 模板
從事過(guò)網(wǎng)頁(yè)編程的人知道，網(wǎng)頁(yè)編程采用的是 HTML + CSS + JS 這樣的組合，其中?HTML?是用來(lái)描述當(dāng)前這個(gè)頁(yè)面的結(jié)構(gòu)，CSS?用來(lái)描述頁(yè)面的樣子，JS?通常是用來(lái)處理這個(gè)頁(yè)面和用戶的交互。
同樣道理，在小程序中也有同樣的角色，其中?WXML?充當(dāng)?shù)木褪穷愃?HTML?的角色。打開?pages/index/index.wxml，你會(huì)看到以下的內(nèi)容:
???????獲取頭像昵稱?????????????????{{userInfo.nickName}}????????????{{motto}}和?HTML?非常相似，WXML?由標(biāo)簽、屬性等等構(gòu)成。但是也有很多不一樣的地方，我們來(lái)一一闡述一下：
標(biāo)簽名字有點(diǎn)不一樣
往往寫 HTML 的時(shí)候，經(jīng)常會(huì)用到的標(biāo)簽是?
div,?p,?span，開發(fā)者在寫一個(gè)頁(yè)面的時(shí)候可以根據(jù)這些基礎(chǔ)的標(biāo)簽組合出不一樣的組件，例如日歷、彈窗等等。換個(gè)思路，既然大家都需要這些組件，為什么我們不能把這些常用的組件包裝起來(lái)，大大提高我們的開發(fā)效率。從上邊的例子可以看到，小程序的?
WXML?用的標(biāo)簽是?view,?button,?text?等等，這些標(biāo)簽就是小程序給開發(fā)者包裝好的基本能力，我們還提供了地圖、視頻、音頻等等組件能力。更多詳細(xì)的組件講述參考下個(gè)章節(jié)?小程序的能力
多了一些?
wx:if?這樣的屬性以及?{{ }}?這樣的表達(dá)式在網(wǎng)頁(yè)的一般開發(fā)流程中，我們通常會(huì)通過(guò)?
JS?操作?DOM?(對(duì)應(yīng)?HTML?的描述產(chǎn)生的樹)，以引起界面的一些變化響應(yīng)用戶的行為。例如，用戶點(diǎn)擊某個(gè)按鈕的時(shí)候，JS?會(huì)記錄一些狀態(tài)到?JS?變量里邊，同時(shí)通過(guò)?DOM?API 操控?DOM?的屬性或者行為，進(jìn)而引起界面一些變化。當(dāng)項(xiàng)目越來(lái)越大的時(shí)候，你的代碼會(huì)充斥著非常多的界面交互邏輯和程序的各種狀態(tài)變量，顯然這不是一個(gè)很好的開發(fā)模式，因此就有了 MVVM 的開發(fā)模式（例如 React, Vue），提倡把渲染和邏輯分離。簡(jiǎn)單來(lái)說(shuō)就是不要再讓?JS?直接操控?DOM，JS?只需要管理狀態(tài)即可，然后再通過(guò)一種模板語(yǔ)法來(lái)描述狀態(tài)和界面結(jié)構(gòu)的關(guān)系即可。小程序的框架也是用到了這個(gè)思路，如果你需要把一個(gè)?
Hello World?的字符串顯示在界面上。WXML 是這么寫 :
{{msg}}JS 只需要管理狀態(tài)即可:
this.setData({?msg:?"Hello?World"?})通過(guò)?{{ }}?的語(yǔ)法把一個(gè)變量綁定到界面上，我們稱為數(shù)據(jù)綁定。僅僅通過(guò)數(shù)據(jù)綁定還不夠完整的描述狀態(tài)和界面的關(guān)系，還需要?
if/else,?for等控制能力，在小程序里邊，這些控制能力都用?wx:?開頭的屬性來(lái)表達(dá)。
更詳細(xì)的文檔可以參考?WXML
WXSS 樣式
WXSS?具有?CSS?大部分的特性，小程序在?WXSS?也做了一些擴(kuò)充和修改。
新增了尺寸單位。在寫?
CSS?樣式時(shí)，開發(fā)者需要考慮到手機(jī)設(shè)備的屏幕會(huì)有不同的寬度和設(shè)備像素比，采用一些技巧來(lái)?yè)Q算一些像素單位。WXSS?在底層支持新的尺寸單位?rpx?，開發(fā)者可以免去換算的煩惱，只要交給小程序底層來(lái)?yè)Q算即可，由于換算采用的浮點(diǎn)數(shù)運(yùn)算，所以運(yùn)算結(jié)果會(huì)和預(yù)期結(jié)果有一點(diǎn)點(diǎn)偏差。提供了全局的樣式和局部樣式。和前邊?
app.json,?page.json?的概念相同，你可以寫一個(gè)?app.wxss?作為全局樣式，會(huì)作用于當(dāng)前小程序的所有頁(yè)面，局部頁(yè)面樣式?page.wxss?僅對(duì)當(dāng)前頁(yè)面生效。此外?
WXSS?僅支持部分?CSS?選擇器
更詳細(xì)的文檔可以參考?WXSS?。
JS 邏輯交互
一個(gè)服務(wù)僅僅只有界面展示是不夠的，還需要和用戶做交互：響應(yīng)用戶的點(diǎn)擊、獲取用戶的位置等等。在小程序里邊，我們就通過(guò)編寫?JS?腳本文件來(lái)處理用戶的操作。
{{?msg?}}點(diǎn)擊我點(diǎn)擊?button?按鈕的時(shí)候，我們希望把界面上?msg?顯示成?"Hello World"，于是我們?cè)?button?上聲明一個(gè)屬性:?bindtap?，在 JS 文件里邊聲明了?clickMe?方法來(lái)響應(yīng)這次點(diǎn)擊操作：
Page({
??clickMe:?function()?{
????this.setData({?msg:?"Hello?World"?})
??}})響應(yīng)用戶的操作就是這么簡(jiǎn)單，更詳細(xì)的事件可以參考文檔?WXML - 事件?。
此外你還可以在 JS 中調(diào)用小程序提供的豐富的 API，利用這些 API 可以很方便的調(diào)起微信提供的能力，例如獲取用戶信息、本地存儲(chǔ)、微信支付等。在前邊的 QuickStart 例子中，在?pages/index/index.js?就調(diào)用了?wx.getUserInfo?獲取微信用戶的頭像和昵稱，最后通過(guò)?setData?把獲取到的信息顯示到界面上。更多 API 可以參考文檔?小程序的API?。
通過(guò)這個(gè)章節(jié)，你了解了小程序涉及到的文件類型以及對(duì)應(yīng)的角色，在下個(gè)章節(jié)中，我們把這一章所涉及到的文件通過(guò) “小程序的框架” 給 “串” 起來(lái)，讓他們都工作起來(lái)。
