小程序項(xiàng)目里的四種文件
.json 后綴的 JSON 配置文件
.wxml 后綴的 WXML 模板文件
.wxss 后綴的 WXSS 樣式文件
.js 后綴的 JS 腳本邏輯文件
JSON 配置
我們可以看到在項(xiàng)目的根目錄有一個(gè) app.json 和 project.config.json，此外在 pages/logs 目錄下還有一個(gè) logs.json翔忽，我們依次來說明一下他們的用途漏隐。
小程序配置 app.json
app.json 是對當(dāng)前小程序的全局配置，包括了小程序的所有頁面路徑、界面表現(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": "WeChat",
"navigationBarTextStyle":"black"
}
}
我們簡單說一下這個(gè)配置各個(gè)項(xiàng)的含義:
- pages字段 —— 用于描述當(dāng)前小程序所有頁面路徑瑟蜈，這是為了讓微信客戶端知道當(dāng)前你的小程序頁面定義在哪個(gè)目錄烟逊。
- window字段 —— 小程序所有頁面的頂部背景顏色，文字顏色定義在這里的铺根。
其他配置項(xiàng)細(xì)節(jié)可以參考文檔 小程序的配置 app.json 宪躯。
工具配置 project.config.json
通常大家在使用一個(gè)工具的時(shí)候，都會針對各自喜好做一些個(gè)性化配置位迂，例如界面顏色访雪、編譯配置等等，當(dāng)你換了另外一臺電腦重新安裝工具的時(shí)候掂林，你還要重新配置臣缀。
考慮到這點(diǎn)，小程序開發(fā)者工具在每個(gè)項(xiàng)目的根目錄都會生成一個(gè) project.config.json泻帮，你在工具上做的任何配置都會寫入到這個(gè)文件精置，當(dāng)你重新安裝工具或者換電腦工作時(shí)，你只要載入同一個(gè)項(xiàng)目的代碼包锣杂，開發(fā)者工具就自動會幫你恢復(fù)到當(dāng)時(shí)你開發(fā)項(xiàng)目時(shí)的個(gè)性化配置脂倦，其中會包括編輯器的顏色、代碼上傳時(shí)自動壓縮等等一系列選項(xiàng)元莫。
其他配置項(xiàng)細(xì)節(jié)可以參考文檔 開發(fā)者工具的配置 赖阻。
頁面配置 page.json
這里的 page.json 其實(shí)用來表示 pages/logs 目錄下的 logs.json 這類和小程序頁面相關(guān)的配置。
如果你整個(gè)小程序的風(fēng)格是藍(lán)色調(diào)踱蠢，那么你可以在 app.json 里邊聲明頂部顏色是藍(lán)色即可火欧。實(shí)際情況可能不是這樣，可能你小程序里邊的每個(gè)頁面都有不一樣的色調(diào)來區(qū)分不同功能模塊，因此我們提供了 page.json苇侵，讓開發(fā)者可以獨(dú)立定義每個(gè)頁面的一些屬性离陶，例如剛剛說的頂部顏色、是否允許下拉刷新等等衅檀。
其他配置項(xiàng)細(xì)節(jié)可以參考文檔 小程序的配置 page.json 招刨。
WXML 模板
從事過網(wǎng)頁編程的人知道，網(wǎng)頁編程采用的是 HTML + CSS + JS 這樣的組合哀军，其中 HTML 是用來描述當(dāng)前這個(gè)頁面的結(jié)構(gòu)沉眶，CSS 用來描述頁面的樣子，JS 通常是用來處理這個(gè)頁面和用戶的交互杉适。
同樣道理谎倔，在小程序中也有同樣的角色，其中 WXML 充當(dāng)?shù)木褪穷愃?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 非常相似，有標(biāo)簽蹬叭、屬性等等構(gòu)成藕咏。但是也有很多不一樣的地方，我們來一一闡述一下：
標(biāo)簽名字有點(diǎn)不一樣 往往寫 HTML 的時(shí)候秽五，經(jīng)常會用到的標(biāo)簽是 div, p, span孽查，開發(fā)者在寫一個(gè)頁面的時(shí)候可以根據(jù)這些基礎(chǔ)的標(biāo)簽組合出不一樣的組件，例如日歷坦喘、彈窗等等盲再。換個(gè)思路，既然大家都需要這些組件瓣铣，為什么我們不能把這些常用的組件包裝起來答朋，大大提高我們的開發(fā)效率。 從上邊的例子可以看到棠笑，小程序的 WXML 用的標(biāo)簽是 view, button, text 等等梦碗，這些標(biāo)簽就是小程序給開發(fā)者包裝好的基本能力，我們還提供了地圖腐晾、視頻叉弦、音頻等等組件能力 更多詳細(xì)的組件講述參考下個(gè)章節(jié) 小程序的能力
-
多了一些 wx:if 這樣的屬性以及 {{ }} 這樣的表達(dá)式 在網(wǎng)頁的一般開發(fā)流程中，我們通常會通過 JS 操作 DOM (對應(yīng) HTML 的描述產(chǎn)生的樹)藻糖，以引起界面的一些變化響應(yīng)用戶的行為淹冰。例如，用戶點(diǎn)擊某個(gè)按鈕的時(shí)候巨柒，JS 會記錄一些狀態(tài)到 JS 變量里邊樱拴，同時(shí)通過 DOM API 操控 DOM 的屬性或者行為柠衍，進(jìn)而引起界面一些變化。當(dāng)項(xiàng)目越來越大的時(shí)候晶乔，你的代碼會充斥著非常多的界面交互邏輯和程序的各種狀態(tài)變量珍坊，顯然這不是一個(gè)很好的開發(fā)模式，因此就有了 MVVM 的開發(fā)模式(例如 React, Vue)正罢，提倡把渲染和邏輯分離阵漏。簡單來說就是不要再讓 JS 直接操控 DOM，JS只需要管理狀態(tài)即可翻具，然后再通過一種模板語法來描述狀態(tài)和界面結(jié)構(gòu)的關(guān)系即可履怯。 小程序的框架也是用到了這個(gè)思路，如果你需要把一個(gè) Hello World 的字符串顯示在界面上裆泳。 WXML 是這么寫 :
<text></text>JS 只需要管理狀態(tài)即可:
this.setData({ msg: "Hello World" })通過 {{ }} 的語法把一個(gè)變量綁定到界面上叹洲，我們稱為數(shù)據(jù)綁定。僅僅通過數(shù)據(jù)綁定還不夠完整的描述狀態(tài)和界面的關(guān)系工禾，還需要 if/else, for等控制能力运提，在小程序里邊，這些控制能力都用 wx: 開頭的屬性來表達(dá)闻葵。 更詳細(xì)的文檔可以參考 WXML
WXSS 樣式
WXSS 具有 CSS 大部分的特性民泵，小程序在 WXSS 也做了一些擴(kuò)充和修改。
- 新增了尺寸單位笙隙。在寫 CSS 樣式時(shí)洪灯，開發(fā)者需要考慮到手機(jī)設(shè)備的屏幕會有不同的寬度和設(shè)備像素比坎缭，采用一些技巧來換算一些像素單位竟痰。WXSS 在底層支持新的尺寸單位 rpx ，開發(fā)者可以免去換算的煩惱掏呼，只要交給小程序底層來換算即可坏快，由于換算采用的浮點(diǎn)數(shù)運(yùn)算，所以運(yùn)算結(jié)果會和預(yù)期結(jié)果有一點(diǎn)點(diǎn)偏差憎夷。
- 提供了全局的樣式和局部樣式莽鸿。和前邊 app.json, page.json 的概念相同，你可以寫一個(gè) app.wxss 作為全局樣式拾给，會作用于當(dāng)前小程序的所有頁面祥得，局部頁面樣式 page.wxss 僅對當(dāng)前頁面生效。
- 此外 WXSS 僅支持部分 CSS 選擇器
更詳細(xì)的文檔可以參考 WXSS 蒋得。
JS 交互邏輯
一個(gè)服務(wù)僅僅只有界面展示是不夠的级及，還需要和用戶做交互：響應(yīng)用戶的點(diǎn)擊、獲取用戶的位置等等额衙。在小程序里邊饮焦，我們就通過編寫 JS 腳本文件來處理用戶的操作怕吴。
<view>{{ msg }}</view>
<button bindtap="clickMe">點(diǎn)擊我</button>
點(diǎn)擊 button 按鈕的時(shí)候，我們希望把界面上 msg 顯示成 "Hello World"县踢，于是我們在 button 上聲明一個(gè)屬性: bindtap 转绷，在 JS 文件里邊聲明了 clickMe 方法來響應(yīng)這次點(diǎn)擊操作：
Page({
clickMe: function() {
this.setData({ msg: "Hello World" })
}
})
響應(yīng)用戶的操作就是這么簡單，更詳細(xì)的事件可以參考文檔 WXML - 事件 硼啤。
此外你還可以在 JS 中調(diào)用小程序提供的豐富的 API议经，利用這些 API 可以很方便的調(diào)起微信提供的能力，例如獲取用戶信息谴返、本地存儲爸业、微信支付等。在前邊的 QuickStart 例子中亏镰，在 pages/index/index.js 就調(diào)用了 wx.getUserInfo 獲取微信用戶的頭像和昵稱扯旷，最后通過 setData 把獲取到的信息顯示到界面上。更多 API 可以參考文檔 小程序的API 索抓。
通過這個(gè)章節(jié)钧忽，你了解了小程序涉及到的文件類型以及對應(yīng)的角色，在下個(gè)章節(jié)中逼肯，我們把這一章所涉及到的文件通過 “小程序的框架” 給 “串” 起來耸黑，讓他們都工作起來。
獲取時(shí)間
function formatTime(date) {
var year = date.getFullYear()
var month = date.getMonth() + 1
var day = date.getDate()
var hour = date.getHours()
var minute = date.getMinutes()
var second = date.getSeconds()
return [year, month, day].map(formatNumber).join('/') + ' ' + [hour, minute, second].map(formatNumber).join(':')
}
formatTime(Date.now())
