上一章中我們把小程序涉及到的文件類(lèi)型闡述了一遍,我們結(jié)合 QuickStart 這個(gè)項(xiàng)目來(lái)講一下這些文件是怎么配合工作的。
微信客戶(hù)端在打開(kāi)小程序之前,會(huì)把整個(gè)小程序的代碼包下載到本地。
緊接著通過(guò) app.json 的 pages 字段就可以知道你當(dāng)前小程序的所有頁(yè)面路徑:
{ "pages":[ "pages/index/index", "pages/logs/logs" ] }
這個(gè)配置說(shuō)明在 QuickStart 項(xiàng)目定義了兩個(gè)頁(yè)面,分別位于 pages/index/index 和 pages/logs/logs 目錄。而寫(xiě)在 pages 字段的第一個(gè)頁(yè)面就是這個(gè)小程序的首頁(yè)(打開(kāi)小程序看到的第一個(gè)頁(yè)面)。
于是微信客戶(hù)端就把首頁(yè)的代碼裝載進(jìn)來(lái),通過(guò)小程序底層的一些機(jī)制,就可以渲染出這個(gè)首頁(yè)。
小程序啟動(dòng)之后,在 app.js 定義的 App 實(shí)例的 onLaunch 回調(diào)會(huì)被執(zhí)行:
App({ onLaunch: function () { // 小程序啟動(dòng)之后 觸發(fā) } })
整個(gè)小程序只有一個(gè) App 實(shí)例,是全部頁(yè)面共享的,更多的事件回調(diào)參考文檔 注冊(cè)程序 App 。
接下來(lái)我們簡(jiǎn)單看看小程序的一個(gè)頁(yè)面是怎么寫(xiě)的。
你可以觀察到 pages/logs/logs 下其實(shí)是包括了4種文件的,微信客戶(hù)端會(huì)先根據(jù) logs.json 配置生成一個(gè)界面,頂部的顏色和文字你都可以在這個(gè) json 文件里邊定義好。緊接著客戶(hù)端就會(huì)裝載這個(gè)頁(yè)面的 WXML 結(jié)構(gòu)和 WXSS 樣式。最后客戶(hù)端會(huì)裝載 logs.js,你可以看到 logs.js 的大體內(nèi)容就是:
Page({ data: { // 參與頁(yè)面渲染的數(shù)據(jù) logs: [] }, onLoad: function () { // 頁(yè)面渲染后 執(zhí)行 } })
Page 是一個(gè)頁(yè)面構(gòu)造器,這個(gè)構(gòu)造器就生成了一個(gè)頁(yè)面。在生成頁(yè)面的時(shí)候,小程序框架會(huì)把 data 數(shù)據(jù)和 index.wxml 一起渲染出最終的結(jié)構(gòu),于是就得到了你看到的小程序的樣子。
在渲染完界面之后,頁(yè)面實(shí)例就會(huì)收到一個(gè) onLoad 的回調(diào),你可以在這個(gè)回調(diào)處理你的邏輯。
有關(guān)于 Page 構(gòu)造器更多詳細(xì)的文檔參考 注冊(cè)頁(yè)面 Page 。
小程序提供了豐富的基礎(chǔ)組件給開(kāi)發(fā)者,開(kāi)發(fā)者可以像搭積木一樣,組合各種組件拼合成自己的小程序。
就像 HTML 的 div, p 等標(biāo)簽一樣,在小程序里邊,你只需要在 WXML 寫(xiě)上對(duì)應(yīng)的組件標(biāo)簽名字就可以把該組件顯示在界面上,例如,你需要在界面上顯示地圖,你只需要這樣寫(xiě)即可:
<map>map>
使用組件的時(shí)候,還可以通過(guò)屬性傳遞值給組件,讓組件可以以不同的狀態(tài)去展現(xiàn),例如,我們希望地圖一開(kāi)始的中心的經(jīng)緯度是廣州,那么你需要聲明地圖的 longitude(中心經(jīng)度) 和 latitude(中心緯度) 兩個(gè)屬性:
<map longitude="廣州經(jīng)度" latitude="廣州緯度">map>
組件的內(nèi)部行為也會(huì)通過(guò)事件的形式讓開(kāi)發(fā)者可以感知,例如用戶(hù)點(diǎn)擊了地圖上的某個(gè)標(biāo)記,你可以在 js 編寫(xiě) markertap 函數(shù)來(lái)處理:
<map bindmarkertap="markertap" longitude="廣州經(jīng)度" latitude="廣州緯度">map>
當(dāng)然你也可以通過(guò) style 或者 class 來(lái)控制組件的外層樣式,以便適應(yīng)你的界面寬度高度等等。
更多的組件可以參考 小程序的組件 。
為了讓開(kāi)發(fā)者可以很方便的調(diào)起微信提供的能力,例如獲取用戶(hù)信息、微信支付等等,小程序提供了很多 API 給開(kāi)發(fā)者去使用。
要獲取用戶(hù)的地理位置時(shí),只需要:
wx.getLocation({ type: 'wgs84', success: (res) => { var latitude = res.latitude // 經(jīng)度 var longitude = res.longitude // 緯度 } })
調(diào)用微信掃一掃能力,只需要:
wx.scanCode({ success: (res) => { console.log(res) } })
需要注意的是:多數(shù) API 的回調(diào)都是異步,你需要處理好代碼邏輯的異步問(wèn)題。
更多的 API 能力見(jiàn) 小程序的API 。
通過(guò)這個(gè)章節(jié)你已經(jīng)大概了解了小程序運(yùn)行的一些基本概念,當(dāng)你開(kāi)發(fā)完一個(gè)小程序之后,你就需要發(fā)布你的小程序。在下個(gè)章節(jié),你會(huì)知道發(fā)布前需要做什么準(zhǔn)備。