[TOC]
## 一、小程序代碼構成
小程序包含一個描述整體程序的`app`和多個描述各自頁面的`page`。
一個小程序主體部分由三個文件組成，必須放在項目的根目錄，如下：
| 文件 | 必需 | 作用 |
| --- | --- | --- |
| app.js | 是 | 小程序邏輯 |
| app.json | 是 | 小程序公共配置 |
| app.wxss | 否 | 小程序公共樣式表 |
一個小程序頁面由四個文件組成，分別是：
| 文件類型 | 必需 | 作用 |
| --- | --- | --- |
| js | 是 | 頁面邏輯 |
| wxml | 是 | 頁面結構 |
| json | 否 | 頁面配置 |
| wxss | 否 | 頁面樣式表 |
> **注意：為了方便開發者減少配置項，描述頁面的四個文件必須具有相同的路徑與文件名。**
```
├── pages 小程序頁面
│?? │── index
│?? │ ├── index.wxml 模版文件
│?? │ ├── index.js 頁面邏輯
│?? │ ├── index.json 頁面配置
│?? │ └── index.wxss 樣式文件
│?? └── logs
│?? ├── logs.wxml
│?? └── logs.js
├── utils 小程序通用工具包
├── app.js 小程序邏輯
├── app.json 小程序公共配置
├── app.wxss 小程序公共樣式表
├── project.config.json 項目配置文件
└── sitemap.json 映射配置文件
```
## 二、JSON 配置
JSON 是一種數據格式，并不是編程語言，在小程序中，JSON扮演的靜態配置的角色。
我們可以看到在項目的根目錄有一個`app.json`和`project.config.json`，此外在`pages/logs`目錄下還有一個`logs.json`，我們依次來說明一下它們的用途。
### 2.1 全局配置
`app.json`是當前小程序的全局配置，包括了小程序的所有頁面路徑、界面表現、網絡超時時間、底部 tab 等。
```
{
"pages": [
"pages/index/index",
"pages/logs/logs"
],
"window": {
"backgroundTextStyle": "light",
"navigationBarBackgroundColor": "#fff",
"navigationBarTitleText": "WeChat",
"navigationBarTextStyle": "black"
},
"style": "v2",
"sitemapLocation": "sitemap.json"
}
```
* `pages`字段：用于描述當前小程序所有頁面路徑，這是為了讓微信客戶端知道當前你的小程序頁面定義在哪個目錄。
* `window`字段：定義小程序所有頁面的頂部背景顏色，文字顏色定義等。
### 2.2 工具配置
通常大家在使用一個工具的時候，都會針對各自喜好做一些個性化配置，例如界面顏色、編譯配置等等，當你換了另外一臺電腦重新安裝工具的時候，你還要重新配置。
考慮到這點，小程序開發者工具在每個項目的根目錄都會生成一個`project.config.json`，你在工具上做的任何配置都會寫入到這個文件，當你重新安裝工具或者換電腦工作時，你只要載入同一個項目的代碼包，開發者工具就自動會幫你恢復到當時你開發項目時的個性化配置，其中會包括編輯器的顏色、代碼上傳時自動壓縮等等一系列選項。
### 2.3 頁面配置
如果你整個小程序的風格是藍色調，那么你可以在`app.json`里邊聲明頂部顏色是藍色即可。實際情況可能不是這樣，可能你小程序里邊的每個頁面都有不一樣的色調來區分不同功能模塊，因此我們提供了`page.json`，讓開發者可以獨立定義每個頁面的一些屬性，例如剛剛說的頂部顏色、是否允許下拉刷新等等。
## 三、WXML 模版
從事過網頁編程的人知道，網頁編程采用的是 HTML + CSS + JS 這樣的組合，其中`HTML`是用來描述當前這個頁面的結構，`CSS`用來描述頁面的樣子，`JS`通常是用來處理這個頁面和用戶的交互。
同樣道理，在小程序中也有同樣的角色，其中`WXML`充當的就是類似`HTML`的角色。打開`pages/index/index.wxml`，你會看到以下的內容：
```
<view class="container">
<view class="userinfo">
<button wx:if="{{!hasUserInfo && canIUse}}" open-type="getUserInfo"
bindgetuserinfo="getUserInfo"> 獲取頭像昵稱 </button>
<block wx:else>
<image bindtap="bindViewTap" class="userinfo-avatar"
src="{{userInfo.avatarUrl}}" mode="cover"></image>
<text class="userinfo-nickname">{{userInfo.nickName}}</text>
</block>
</view>
<view class="usermotto">
<text class="user-motto">{{motto}}</text>
</view>
</view>
```
和`HTML`非常相似，`WXML`由標簽、屬性等等構成。但是也有很多不一樣的地方，我們來一一闡述一下：
* **標簽名字有點不一樣**
往往寫 HTML 的時候，經常會用到的標簽是`div`,`p`,`span`，開發者在寫一個頁面的時候可以根據這些基礎的標簽組合出不一樣的組件，例如日歷、彈窗等等。換個思路，既然大家都需要這些組件，為什么我們不能把這些常用的組件包裝起來，大大提高我們的開發效率。
從上邊的例子可以看到，小程序的`WXML`用的標簽是`view`,`button`,`text`等等，這些標簽就是小程序給開發者包裝好的基本能力，我們還提供了地圖、視頻、音頻等等組件能力。
* **多了一些`wx:if`這樣的屬性以及`{{ }}`這樣的表達式**
在網頁的一般開發流程中，我們通常會通過`JS`操作`DOM`(對應`HTML`的描述產生的樹)，以引起界面的一些變化響應用戶的行為。例如，用戶點擊某個按鈕的時候，`JS`會記錄一些狀態到`JS`變量里邊，同時通過`DOM`API 操控`DOM`的屬性或者行為，進而引起界面一些變化。當項目越來越大的時候，你的代碼會充斥著非常多的界面交互邏輯和程序的各種狀態變量，顯然這不是一個很好的開發模式，因此就有了 MVVM 的開發模式（例如 React, Vue），提倡把渲染和邏輯分離。簡單來說就是不要再讓`JS`直接操控`DOM`，`JS`只需要管理狀態即可，然后再通過一種模板語法來描述狀態和界面結構的關系即可。
小程序的框架也是用到了這個思路，如果你需要把一個`Hello World`的字符串顯示在界面上。
WXML 是這么寫 :
~~~
<text>{{msg}}</text>
~~~
JS 只需要管理狀態即可:
~~~
this.setData({ msg: "Hello World" })
~~~
通過`{{ }}`的語法把一個變量綁定到界面上，我們稱為數據綁定。僅僅通過數據綁定還不夠完整的描述狀態和界面的關系，還需要`if`/`else`,`for`等控制能力，在小程序里邊，這些控制能力都用`wx:`開頭的屬性來表達。
## 四、WXSS 樣式
`WXSS`具有`CSS`大部分的特性，小程序在`WXSS`也做了一些擴充和修改。
1. 新增了尺寸單位。在寫`CSS`樣式時，開發者需要考慮到手機設備的屏幕會有不同的寬度和設備像素比，采用一些技巧來換算一些像素單位。`WXSS`在底層支持新的尺寸單位`rpx`，開發者可以免去換算的煩惱，只要交給小程序底層來換算即可，由于換算采用的浮點數運算，所以運算結果會和預期結果有一點點偏差。
2. 提供了全局的樣式和局部樣式。和前邊`app.json`,`page.json`的概念相同，你可以寫一個`app.wxss`作為全局樣式，會作用于當前小程序的所有頁面，局部頁面樣式`page.wxss`僅對當前頁面生效。
3. 此外`WXSS`僅支持部分`CSS`選擇器。
## 五、JS 邏輯交互
一個服務僅僅只有界面展示是不夠的，還需要和用戶做交互：響應用戶的點擊、獲取用戶的位置等等。在小程序里邊，我們就通過編寫`JS`腳本文件來處理用戶的操作。
~~~
<view>{{ msg }}</view>
<button bindtap="clickMe">點擊我</button>
~~~
點擊`button`按鈕的時候，我們希望把界面上`msg`顯示成`"Hello World"`，于是我們在`button`上聲明一個屬性:`bindtap`，在 JS 文件里邊聲明了`clickMe`方法來響應這次點擊操作：
~~~
Page({
clickMe: function() {
this.setData({ msg: "Hello World" })
}
})
~~~
