微信小程序 小程序代碼構(gòu)成

小程序代碼構(gòu)成

?在上一章中，我們通過開發(fā)者工具快速創(chuàng)建了一個 QuickStart 項目。你可以留意到這個項目里邊生成了不同類型的文件:

1. .json 后綴的 JSON 配置文件
2. .wxml 后綴的 WXML 模板文件
3. .wxss 后綴的 WXSS 樣式文件
4. .js 后綴的 JS 腳本邏輯文件

接下來我們分別看看這4種文件的作用。

JSON 配置

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

我們可以看到在項目的根目錄有一個 app.json 和 project.config.json，此外在 pages/logs 目錄下還有一個 logs.json，我們依次來說明一下它們的用途。

小程序配置 app.json

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

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

我們簡單說一下這個配置各個項的含義:

1. pages字段 —— 用于描述當(dāng)前小程序所有頁面路徑，這是為了讓微信客戶端知道當(dāng)前你的小程序頁面定義在哪個目錄。
2. window字段 —— 定義小程序所有頁面的頂部背景顏色，文字顏色定義等。

其他配置項細節(jié)可以參考文檔 小程序的配置 app.json 。

工具配置 project.config.json

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

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

其他配置項細節(jié)可以參考文檔 開發(fā)者工具的配置 。

頁面配置 page.json

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

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

其他配置項細節(jié)可以參考文檔 頁面配置 。

JSON 語法

這里說一下小程序里JSON配置的一些注意事項。

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

JSON的值只能是以下幾種數(shù)據(jù)格式，其他任何格式都會觸發(fā)報錯，例如 JavaScript 中的 undefined。

1. 數(shù)字，包含浮點數(shù)和整數(shù)
2. 字符串，需要包裹在雙引號中
3. Bool值，true 或者 false
4. 數(shù)組，需要包裹在方括號中 []
5. 對象，需要包裹在大括號中 {}
6. Null

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

WXML 模板

從事過網(wǎng)頁編程的人知道，網(wǎng)頁編程采用的是 HTML + CSS + JS 這樣的組合，其中 HTML 是用來描述當(dāng)前這個頁面的結(jié)構(gòu)，CSS 用來描述頁面的樣子，JS 通常是用來處理這個頁面和用戶的交互。

同樣道理，在小程序中也有同樣的角色，其中 WXML 充當(dāng)?shù)木褪穷愃?nbsp;HTML 的角色。打開 pages/index/index.wxml，你會看到以下的內(nèi)容:

<view class="container">
  <view class="userinfo">
    <button wx:if="{{!hasUserInfo && canIUse}}"> 獲取頭像昵稱 </button>
    <block wx:else>
      <image src="{{userInfo.avatarUrl}}" background-size="cover"></image>
      <text class="userinfo-nickname">{{userInfo.nickName}}</text>
    </block>
  </view>
  <view class="usermotto">
    <text class="user-motto">{{motto}}</text>
  </view>
</view>

和 HTML 非常相似，WXML 由標簽、屬性等等構(gòu)成。但是也有很多不一樣的地方，我們來一一闡述一下：

1. 標簽名字有點不一樣往往寫 HTML 的時候，經(jīng)常會用到的標簽是 div, p, span，開發(fā)者在寫一個頁面的時候可以根據(jù)這些基礎(chǔ)的標簽組合出不一樣的組件，例如日歷、彈窗等等。換個思路，既然大家都需要這些組件，為什么我們不能把這些常用的組件包裝起來，大大提高我們的開發(fā)效率。從上邊的例子可以看到，小程序的 WXML 用的標簽是 view, button, text 等等，這些標簽就是小程序給開發(fā)者包裝好的基本能力，我們還提供了地圖、視頻、音頻等等組件能力。更多詳細的組件講述參考下個章節(jié) 小程序的能力
2. 多了一些 wx:if 這樣的屬性以及 {{ }} 這樣的表達式在網(wǎng)頁的一般開發(fā)流程中，我們通常會通過 JS 操作 DOM (對應(yīng) HTML 的描述產(chǎn)生的樹)，以引起界面的一些變化響應(yīng)用戶的行為。例如，用戶點擊某個按鈕的時候，JS 會記錄一些狀態(tài)到 JS 變量里邊，同時通過 DOM API 操控 DOM 的屬性或者行為，進而引起界面一些變化。當(dāng)項目越來越大的時候，你的代碼會充斥著非常多的界面交互邏輯和程序的各種狀態(tài)變量，顯然這不是一個很好的開發(fā)模式，因此就有了 MVVM 的開發(fā)模式（例如 React, Vue），提倡把渲染和邏輯分離。簡單來說就是不要再讓 JS 直接操控 DOM，JS 只需要管理狀態(tài)即可，然后再通過一種模板語法來描述狀態(tài)和界面結(jié)構(gòu)的關(guān)系即可。小程序的框架也是用到了這個思路，如果你需要把一個 Hello World 的字符串顯示在界面上。WXML 是這么寫 :<text>{{msg}}</text> JS 只需要管理狀態(tài)即可:this.setData({ msg: "Hello World" }) 通過 {{ }} 的語法把一個變量綁定到界面上，我們稱為數(shù)據(jù)綁定。僅僅通過數(shù)據(jù)綁定還不夠完整的描述狀態(tài)和界面的關(guān)系，還需要 if/else, for等控制能力，在小程序里邊，這些控制能力都用 wx: 開頭的屬性來表達。

更詳細的文檔可以參考 WXML

WXSS 樣式

WXSS 具有 CSS 大部分的特性，小程序在 WXSS 也做了一些擴充和修改。

1. 新增了尺寸單位。在寫 CSS 樣式時，開發(fā)者需要考慮到手機設(shè)備的屏幕會有不同的寬度和設(shè)備像素比，采用一些技巧來換算一些像素單位。WXSS 在底層支持新的尺寸單位 rpx ，開發(fā)者可以免去換算的煩惱，只要交給小程序底層來換算即可，由于換算采用的浮點數(shù)運算，所以運算結(jié)果會和預(yù)期結(jié)果有一點點偏差。
2. 提供了全局的樣式和局部樣式。和前邊 app.json, page.json 的概念相同，你可以寫一個 app.wxss 作為全局樣式，會作用于當(dāng)前小程序的所有頁面，局部頁面樣式 page.wxss 僅對當(dāng)前頁面生效。
3. 此外 WXSS 僅支持部分 CSS 選擇器

更詳細的文檔可以參考 WXSS 。

JS 邏輯交互

一個服務(wù)僅僅只有界面展示是不夠的，還需要和用戶做交互：響應(yīng)用戶的點擊、獲取用戶的位置等等。在小程序里邊，我們就通過編寫 JS 腳本文件來處理用戶的操作。

<view>{{ msg }}</view>
<button bindtap="clickMe">點擊我</button>

點擊 button 按鈕的時候，我們希望把界面上 msg 顯示成 "Hello World"，于是我們在 button 上聲明一個屬性: bindtap ，在 JS 文件里邊聲明了 clickMe 方法來響應(yīng)這次點擊操作：

Page({
  clickMe: function() {
    this.setData({ msg: "Hello World" })
  }
})

響應(yīng)用戶的操作就是這么簡單，更詳細的事件可以參考文檔 WXML - 事件 。

此外你還可以在 JS 中調(diào)用小程序提供的豐富的 API，利用這些 API 可以很方便的調(diào)起微信提供的能力，例如獲取用戶信息、本地存儲、微信支付等。在前邊的 QuickStart 例子中，在 pages/index/index.js 就調(diào)用了 wx.getUserInfo 獲取微信用戶的頭像和昵稱，最后通過 setData 把獲取到的信息顯示到界面上。更多 API 可以參考文檔 小程序的API 。

通過這個章節(jié)，你了解了小程序涉及到的文件類型以及對應(yīng)的角色，在下個章節(jié)中，我們把這一章所涉及到的文件通過 “小程序的框架” 給 “串” 起來，讓他們都工作起來。