# 小程序代碼構成
?在上一章中,我們通過開發者工具快速創建了一個 QuickStart 項目。你可以留意到這個項目里邊生成了不同類型的文件:
1. .json?后綴的?JSON?配置文件
2. .wxml?后綴的?WXML?模板文件
3. .wxss?后綴的?WXSS?樣式文件
4. .js?后綴的?JS?腳本邏輯文件
接下來我們分別看看這4種文件的作用。
## [](https://developers.weixin.qq.com/miniprogram/dev/framework/quickstart/code.html#JSON-%E9%85%8D%E7%BD%AE)JSON 配置
JSON 是一種數據格式,并不是編程語言,在小程序中,JSON扮演的靜態配置的角色。
我們可以看到在項目的根目錄有一個?app.json?和?project.config.json,此外在?pages/logs?目錄下還有一個?logs.json,我們依次來說明一下它們的用途。
### [](https://developers.weixin.qq.com/miniprogram/dev/framework/quickstart/code.html#%E5%B0%8F%E7%A8%8B%E5%BA%8F%E9%85%8D%E7%BD%AE-app-json)小程序配置 app.json
app.json?是當前小程序的全局配置,包括了小程序的所有頁面路徑、界面表現、網絡超時時間、底部 tab 等。QuickStart 項目里邊的?app.json?配置內容如下:
~~~
{
"pages":[
"pages/index/index",
"pages/logs/logs"
],
"window":{
"backgroundTextStyle":"light",
"navigationBarBackgroundColor": "#fff",
"navigationBarTitleText": "WeChat",
"navigationBarTextStyle":"black"
}
}
~~~
我們簡單說一下這個配置各個項的含義:
1. pages字段 —— 用于描述當前小程序所有頁面路徑,這是為了讓微信客戶端知道當前你的小程序頁面定義在哪個目錄。
2. window字段 —— 定義小程序所有頁面的頂部背景顏色,文字顏色定義等。
其他配置項細節可以參考文檔?[小程序的配置 app.json](https://www.w3cschool.cn/weixinapp/weixinapp-xsnq38rf.html)?。
### [](https://developers.weixin.qq.com/miniprogram/dev/framework/quickstart/code.html#%E5%B7%A5%E5%85%B7%E9%85%8D%E7%BD%AE-project-config-json)工具配置 project.config.json
通常大家在使用一個工具的時候,都會針對各自喜好做一些個性化配置,例如界面顏色、編譯配置等等,當你換了另外一臺電腦重新安裝工具的時候,你還要重新配置。
考慮到這點,小程序開發者工具在每個項目的根目錄都會生成一個?project.config.json,你在工具上做的任何配置都會寫入到這個文件,當你重新安裝工具或者換電腦工作時,你只要載入同一個項目的代碼包,開發者工具就自動會幫你恢復到當時你開發項目時的個性化配置,其中會包括編輯器的顏色、代碼上傳時自動壓縮等等一系列選項。
其他配置項細節可以參考文檔?[開發者工具的配置](https://www.w3cschool.cn/weixinapp/weixinapp-edit.html)?。
### [](https://developers.weixin.qq.com/miniprogram/dev/framework/quickstart/code.html#%E9%A1%B5%E9%9D%A2%E9%85%8D%E7%BD%AE-page-json)頁面配置 page.json
這里的?page.json?其實用來表示 pages/logs 目錄下的?logs.json?這類和小程序頁面相關的配置。
如果你整個小程序的風格是藍色調,那么你可以在?app.json?里邊聲明頂部顏色是藍色即可。實際情況可能不是這樣,可能你小程序里邊的每個頁面都有不一樣的色調來區分不同功能模塊,因此我們提供了?page.json,讓開發者可以獨立定義每個頁面的一些屬性,例如剛剛說的頂部顏色、是否允許下拉刷新等等。
其他配置項細節可以參考文檔?[頁面配置](https://www.w3cschool.cn/weixinapp/weixinapp-qwcr38rg.html)?。
### [](https://developers.weixin.qq.com/miniprogram/dev/framework/quickstart/code.html#JSON-%E8%AF%AD%E6%B3%95)JSON 語法
這里說一下小程序里JSON配置的一些注意事項。
JSON文件都是被包裹在一個大括號中 {},通過key-value的方式來表達數據。JSON的Key必須包裹在一個雙引號中,在實踐中,編寫 JSON 的時候,忘了給 Key 值加雙引號或者是把雙引號寫成單引號是常見錯誤。
JSON的值只能是以下幾種數據格式,其他任何格式都會觸發報錯,例如 JavaScript 中的 undefined。
1. 數字,包含浮點數和整數
2. 字符串,需要包裹在雙引號中
3. Bool值,true 或者 false
4. 數組,需要包裹在方括號中 \[\]
5. 對象,需要包裹在大括號中 {}
6. Null
還需要注意的是 JSON 文件中無法使用注釋,試圖添加注釋將會引發報錯。
## [](https://developers.weixin.qq.com/miniprogram/dev/framework/quickstart/code.html#WXML-%E6%A8%A1%E6%9D%BF)WXML 模板
從事過網頁編程的人知道,網頁編程采用的是 HTML + CSS + JS 這樣的組合,其中?HTML?是用來描述當前這個頁面的結構,CSS?用來描述頁面的樣子,JS?通常是用來處理這個頁面和用戶的交互。
同樣道理,在小程序中也有同樣的角色,其中?WXML?充當的就是類似?HTML?的角色。打開?pages/index/index.wxml,你會看到以下的內容:
~~~
<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?由標簽、屬性等等構成。但是也有很多不一樣的地方,我們來一一闡述一下:
1. 標簽名字有點不一樣往往寫 HTML 的時候,經常會用到的標簽是?div,?p,?span,開發者在寫一個頁面的時候可以根據這些基礎的標簽組合出不一樣的組件,例如日歷、彈窗等等。換個思路,既然大家都需要這些組件,為什么我們不能把這些常用的組件包裝起來,大大提高我們的開發效率。從上邊的例子可以看到,小程序的?WXML?用的標簽是?view,?button,?text?等等,這些標簽就是小程序給開發者包裝好的基本能力,我們還提供了地圖、視頻、音頻等等組件能力。更多詳細的組件講述參考下個章節?[小程序的能力](https://developers.weixin.qq.com/miniprogram/dev/framework/quickstart/framework.html)
2. 多了一些?wx:if?這樣的屬性以及?{{ }}?這樣的表達式在網頁的一般開發流程中,我們通常會通過?JS?操作?DOM?(對應?HTML?的描述產生的樹),以引起界面的一些變化響應用戶的行為。例如,用戶點擊某個按鈕的時候,JS?會記錄一些狀態到?JS?變量里邊,同時通過?DOM?API 操控?DOM?的屬性或者行為,進而引起界面一些變化。當項目越來越大的時候,你的代碼會充斥著非常多的界面交互邏輯和程序的各種狀態變量,顯然這不是一個很好的開發模式,因此就有了 MVVM 的開發模式(例如 React, Vue),提倡把渲染和邏輯分離。簡單來說就是不要再讓?JS?直接操控?DOM,JS?只需要管理狀態即可,然后再通過一種模板語法來描述狀態和界面結構的關系即可。小程序的框架也是用到了這個思路,如果你需要把一個?Hello World?的字符串顯示在界面上。WXML 是這么寫 :{{msg}} JS 只需要管理狀態即可:this.setData({ msg: "Hello World" }) 通過?{{ }}?的語法把一個變量綁定到界面上,我們稱為數據綁定。僅僅通過數據綁定還不夠完整的描述狀態和界面的關系,還需要?if/else,?for等控制能力,在小程序里邊,這些控制能力都用?wx:?開頭的屬性來表達。
更詳細的文檔可以參考?[WXML](https://www.w3cschool.cn/weixinapp/weixinapp-832u38rs.html)
## [](https://developers.weixin.qq.com/miniprogram/dev/framework/quickstart/code.html#WXSS-%E6%A0%B7%E5%BC%8F)WXSS 樣式
WXSS?具有?CSS?大部分的特性,小程序在?WXSS?也做了一些擴充和修改。
1. 新增了尺寸單位。在寫?CSS?樣式時,開發者需要考慮到手機設備的屏幕會有不同的寬度和設備像素比,采用一些技巧來換算一些像素單位。WXSS?在底層支持新的尺寸單位?rpx?,開發者可以免去換算的煩惱,只要交給小程序底層來換算即可,由于換算采用的浮點數運算,所以運算結果會和預期結果有一點點偏差。
2. 提供了全局的樣式和局部樣式。和前邊?app.json,?page.json?的概念相同,你可以寫一個?app.wxss?作為全局樣式,會作用于當前小程序的所有頁面,局部頁面樣式?page.wxss?僅對當前頁面生效。
3. 此外?WXSS?僅支持部分?CSS?選擇器
更詳細的文檔可以參考?[WXSS](https://www.w3cschool.cn/weixinapp/weixinapp-y7ki38rt.html)?。
## [](https://developers.weixin.qq.com/miniprogram/dev/framework/quickstart/code.html#JS-%E9%80%BB%E8%BE%91%E4%BA%A4%E4%BA%92)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" })
}
})
~~~
響應用戶的操作就是這么簡單,更詳細的事件可以參考文檔?[WXML - 事件](https://www.w3cschool.cn/weixinapp/weixinapp-w5lp38rv.html)?。
此外你還可以在 JS 中調用小程序提供的豐富的 API,利用這些 API 可以很方便的調起微信提供的能力,例如獲取用戶信息、本地存儲、微信支付等。在前邊的 QuickStart 例子中,在?pages/index/index.js?就調用了?[wx.getUserInfo](https://www.w3cschool.cn/weixinapp/weixinapp-open.html)?獲取微信用戶的頭像和昵稱,最后通過?setData?把獲取到的信息顯示到界面上。更多 API 可以參考文檔?[小程序的API](https://www.w3cschool.cn/weixinapp/weixinapp-ercd38rr.html)?。
通過這個章節,你了解了小程序涉及到的文件類型以及對應的角色,在下個章節中,我們把這一章所涉及到的文件通過 “小程序的框架” 給 “串” 起來,讓他們都工作起來。
- 惠惠軟件-開發自助學習系統
- 一.微信公眾號(服務號)申請流程
- 二.申請所需提前準備資料
- 三.認證微信公眾號:申請微信小程序流程
- 四.微信小程序安裝和開發環境
- 五.微信小程序如何上傳、提交審核、發布操作
- 六.微信小程序開發教程手冊
- 0.1微信小程序 小程序簡介
- 0.2微信小程序 開始第一步
- 0.3微信小程序 小程序代碼構成
- 0.4微信小程序 小程序宿主環境
- 0.5微信小程序 小程序協同工作和發布
- 0.6微信小程序 目錄結構
- 0.7微信小程序 全局配置
- 0.8微信小程序 頁面配置
- 0.9微信小程序 sitemap配置
- 0.10微信小程序 場景值
- 0.11微信小程序 注冊小程序
- 0.12微信小程序 注冊頁面
- 0.13微信小程序 頁面生命周期
- 0.14微信小程序 頁面路由
- 0.15微信小程序 模塊化
- 0.16微信小程序 API
- 0.17微信小程序 運行環境
- 0.18微信小程序 JavaScript支持情況
- 0.19微信小程序 運行機制
- 0.20微信小程序 更新機制
- 0.21微信小程序 廣告·Banner 廣告
- 0.22微信小程序 安全指引·開發原則與注意事項
- 0.23微信小程序 調試
- 0.24微信小程序 啟動性能
- 0.25微信小程序 運行時性能
- 0.26微信小程序 性能分析工具
- 0.27微信小程序 體驗評分
- 八.小程序的美工
- 8.1圖片大小
- 8.2顏色代碼
- 8.3小程序的美工技巧
- 九.微信小程序-定制開發
- 十.微信支付申請流程
- 十一.小程序支付對接流程
- 十二.微信小程序使用中常見問題匯總
- 十二.小程序開發中遇到的問題—匯總
- 十四.小程序問題及解決
- 十五.網站開發定制
- 1.開發定制流程
- 2.搭建網站的過程
- 3.做網站基本費用
- 4.服務器選什么系統更好?
- 十六.常用工具、軟件網站推薦