直接進主題,從前端程式碼開始看。

整個小程序由 App(obj) 註冊,傳入的物件用來宣告生命週期函式等內容。其他檔案可以透過全域方法 getApp() 拿到這個實例,進而直接存取它的屬性或方法,例如 getApp().globalData。
//app.js App({ onLaunch: function () { //調用API從本地緩存中獲取數據 var logs = wx.getStorageSync('logs') || [] logs.unshift(Date.now()) wx.setStorageSync('logs', logs) }, getUserInfo:function(cb){ var that = this if(this.globalData.userInfo){ typeof cb == "function" && cb(this.globalData.userInfo) }else{ //調用登錄接口 wx.login({ success: function () { wx.getUserInfo({ success: function (res) { that.globalData.userInfo = res.userInfo typeof cb == "function" && cb(that.globalData.userInfo) } }) } }) } }, globalData:{ userInfo:null } })
可以把 app.js 理解成整個應用的啟動檔,同時也是擴充全域能力的地方。逐段來看它自帶的幾個成員:
onLaunch 是鉤子函式,小程序初始化完成後會自動執行一次;整個生命週期內若不主動呼叫,它不會再跑第二次。
var logs = wx.getStorageSync('logs') || [] 從本地快取取出 logs,取不到就給個空陣列,作用和 HTML5 的 localStorage 類似。接著 logs.unshift(Date.now()) 把本次啟動時間塞到最前面,再由 wx.setStorageSync('logs', logs) 寫回快取。因為 wx 是全域物件,任何檔案都能直接 wx.getStorageSync('logs') 取用。
getUserInfo 顧名思義負責取得登入使用者資訊,等於對外提供了一個方法;其他頁面不呼叫,它自然不會執行。使用方式是 getApp().getUserInfo(function(userinfo){ console.log(userinfo); })。
getUserInfo:function(cb){//參數為cb,類型為函數 var that = this if(this.globalData.userInfo){//用戶信息不為空 typeof cb == "function" && cb(this.globalData.userInfo)//如果參數cb的類型為函數,那麼執行cb,獲取用戶信息; }else{//如果用戶信息為空,也就是說第一次調用getUserInfo,會調用用戶登錄接口。 wx.login({ success: function () { wx.getUserInfo({ success: function (res) { console.log(res) that.globalData.userInfo = res.userInfo//把用戶信息賦給globalData,如果再次調用getUserInfo函數的時候,不需要調用登錄接口 typeof cb == "function" && cb(that.globalData.userInfo)//如果參數cb類型為函數,執行cb,獲取用戶信息 } }) } }) } }
globalData 則是放全域資料的地方,各處都能讀取。
app.json 負責小程序的全域配置,包括頁面路徑、視窗表現、網路超時時間、多 tab 設定等。其中最重要的是 pages:必填的陣列,元素為字串型別的頁面路徑,用來宣告小程序由哪些頁面組成,而第一項就是啟動頁。
{ "pages":[ "pages/index/index", "pages/logs/logs" ], "window":{ "backgroundTextStyle":"light", "navigationBarBackgroundColor": "#fff", "navigationBarTitleText": "WeChat", "navigationBarTextStyle":"black" } }
接著看 index 與 logs 兩個資料夾。小程序把每個頁面的 js、wxss、wxml 各自歸檔,結構一眼就看懂。
index 是啟動頁,底下三個檔案各司其職:js 管行為、wxss 管樣式、wxml 管結構。值得注意的是命名必須與資料夾內的 wxml 保持一致,否則樣式和邏輯都不會生效。這種「同資料夾、同檔名」的約定我個人很喜歡——整齊、職責清楚,複雜度自然下降。
index.wxml 就是常見的模板檔,資料驅動,寫過 MVC / MVVM 的人不會陌生,畢竟它背後的設計思路源自 React。
<!--index.wxml--> <view class="container">//視圖容器 <view bindtap="bindViewTap" class="userinfo">//bindtap為容器綁定點擊觸摸事件,在觸摸離開時觸發bindViewTap事件處理函數,bindViewTap通過index.js page()設置添加 <image class="userinfo-avatar" src="{{userInfo.avatarUrl}}" background-size="cover"></image>//大雙括號的變量來自於index.js的data對象解析成對應的值,而且是實時的 <text class="userinfo-nickname">{{userInfo.nickName}}</text> </view> <view class="usermotto"> <text class="user-motto">{{motto}}</text> </view> </view>
index.js 的寫法幾乎和 React 如出一不做二不休,換湯不換藥。Page() 用來註冊頁面,接受一個物件參數,裡面放初始資料、生命週期函式與事件處理函式。
var app = getApp() // 獲取入口文件app的應用實例 Page({ data: { motto: 'Hello World', userInfo: {} }, //自定義事件處理函數,點擊.userinfo的容易觸發此函數 bindViewTap: function() { wx.navigateTo({//全局對象wx的跳轉頁面方法 url: '../logs/logs' }) }, onLoad: function () {//發生頁面加載時,自動觸發該生命周期函數 console.log('onLoad') var that = this //調用應用實例的方法獲取全局數據 app.getUserInfo(function(userInfo){ //更新數據,頁面自動渲染 that.setData({ userInfo:userInfo }) }) } })
index.wxss 只作用於當前頁面,同名樣式會覆蓋 app.wxss 的全域設定。
再看 logs 資料夾,裡面是 logs.wxml、logs.js、logs.wxss、logs.json,同樣遵循同名原則。
<!--logs.wxml--> <view class="container log-list"> <block wx:for="{{logs}}" wx:for-item="log">//block容器作用,無其他實際含義。wx:for作用:遍歷logs數組,遍歷多少次,block塊就會復制多少次,for-item等同於為遍歷元素起一個變量名,方便引用。 <text class="log-item">{{index + 1}}. {{log}}</text> </block> </view>
//logs.js var util = require('../../utils/util.js') //util.js相當於一個函數庫,我們可以在這個文件內自定義擴展和封裝一些常用的函數和方法 Page({ data: { logs: [] }, onLoad: function () { this.setData({ logs: (wx.getStorageSync('logs') || []).map(function (log) {//通過wx.getStorageSync獲取本地緩存的logs日志數據 return util.formatTime(new Date(log))//日期格式化 }) }) } })
{ "navigationBarTitleText": "查看啟動日志" //當前頁面配置文件,設置window當前頁面頂部導航欄標題等相關內容 }
頁面的基本結構與邏輯就這麼多,官方暴露給我們的東西並不難懂。剩下的官方元件與 API 還有很多值得深挖,慢慢來就好。