微信小程序開發基礎知識總結

微信小程序在無論在功能、文檔及相關支持方面,都是優于前面幾種微信賬號類型,它提供了很多原生程序才有的接口,使得我們的小程序在很多方面突破H5頁面應用的限制,更加接近原生程序的功能,因此微信小程序具有很大的前景想象力。它提供了自己的視圖層描述語言WXML和WXSS,以及基于JavaScript的邏輯層框架,并在視圖層與邏輯層間提供了數據傳輸和事件系統,可以讓開發者可以方便的聚焦于數據與邏輯上。

1、小程序的目錄結構

小程序的目錄結構如下所示。

其中項目級別的的文件包括app.js、app.json、app.wxss這三個。其中.js后綴的是腳本文件,.json后綴的文件是配置文件,.wxss后綴的是樣式表文件。

頁面級別可以包含很多個頁面,如index,detail等頁面,每個頁面都包含.js,.json,.wxml,.wxss這些文件,其中.wxml為頁面視圖文件,是自定義標簽的HTML頁面。

app.js是小程序的腳本代碼。我們可以在這個文件中監聽并處理小程序的生命周期函數、聲明全局變量,可以調用框架提供的豐富的API。

app.json是對整個小程序的全局配置。我們可以在這個文件中配置小程序是由哪些頁面組成,配置小程序的窗口?背景色,配置導航條樣式,配置默認標題。

app.wxss是整個小程序的公共樣式表。我們可以在頁面組件的class屬性上直接使用app.wxss中聲明的樣式規則。

一個小程序主體部分由三個文件組成,必須放在項目的根目錄。

微信小程序中的每一個頁面的【路徑+頁面名】都需要寫在app.json的pages中,且pages中的第一個頁面是小程序的首頁。

每一個小程序頁面是由同路徑下同名的四個不同后綴文件的組成,如:index.js、index.wxml、index.wxss、index.json。.js后綴的文件是腳本文件,.json后綴的文件是配置文件,.wxss后綴的是樣式表文件,.wxml后綴的文件是頁面結構文件。

index.json是頁面的配置文件:頁面的配置文件是非必要的。當有頁面的配置文件時,配置項在該頁面會覆蓋app.json的window中相同的配置項。如果沒有指定的頁面配置文件,則在該頁面直接使用app.json中的默認配置。

邏輯層(App Service)

小程序開發框架的邏輯層是由JavaScript編寫。

邏輯層將數據進行處理后發送給視圖層,同時接受視圖層的事件反饋。在JavaScript的基礎上,我們做了一些修改,以方便地開發小程序。

增加App和Page方法,進行程序和頁面的注冊。

增加getApp和getCurrentPages方法,分別用來獲取App實例和當前頁面棧。

提供豐富的API,如微信用戶數據,掃一掃,支付等微信特有能力。

每個頁面有獨立的作用域,并提供模塊化能力。

由于框架并非運行在瀏覽器中,所以JavaScript在web中一些能力都無法使用,如document,window等。

開發者寫的所有代碼最終將會打包成一份JavaScript,并在小程序啟動的時候運行,直到小程序銷毀。類似ServiceWorker,所以邏輯層也稱之為App Service。

視圖層

框架的視圖層由WXML與WXSS編寫,由組件來進行展示。

將邏輯層的數據反應成視圖,同時將視圖層的事件發送給邏輯層。

WXML(WeiXin Markup language)用于描述頁面的結構。

WXSS(WeiXin Style Sheet)用于描述頁面的樣式。

組件(Component)是視圖的基本組成單元。

基礎組件

框架為開發者提供了一系列基礎組件,開發者可以通過組合這些基礎組件進行快速開發。

什么是組件:

組件是視圖層的基本組成單元。

組件自帶一些功能與微信風格的樣式。

一個組件通常包括開始標簽和結束標簽,屬性用來修飾這個組件,內容在兩個標簽之內。

Content goes here ...

注意:所有組件與屬性都是小寫,以連字符-連接

API

框架提供豐富的微信原生API,可以方便的調起微信提供的能力,如獲取用戶信息,本地存儲,支付功能等。

說明:

wx.on開頭的API是監聽某個事件發生的API接口,接受一個CALLBACK函數作為參數。當該事件觸發時,會調用CALLBACK函數。

如未特殊約定,其他API接口都接受一個OBJECT作為參數。

OBJECT中可以指定success,?fail,?complete來接收接口調用結果。

參數名

類型

必填

說明

success

Function

接口調用成功的回調函數

fail

Function

接口調用失敗的回調函數

complete

Function

接口調用結束的回調函數(調用成功、失敗都會執行)

2、小程序接口功能列表

框架提供豐富的微信原生API,可以方便的調起微信提供的能力,如獲取用戶信息,本地存儲,支付功能等。

1)網絡API列表:

wx.request發起網絡請求

wx.uploadFile上傳文件

wx.downloadFile下載文件

wx.connectSocket創建WebSocket連接

wx.onSocketOpen監聽WebSocket打開

wx.onSocketError監聽WebSocket錯誤

wx.sendSocketMessage發送WebSocket消息

wx.onSocketMessage接受WebSocket消息

wx.closeSocket關閉WebSocket連接

wx.onSocketClose監聽WebSocket關閉

2)媒體API列表:

wx.chooseImage從相冊選擇圖片,或者拍照

wx.previewImage預覽圖片

wx.startRecord開始錄音

wx.stopRecord結束錄音

wx.playVoice播放語音

wx.pauseVoice暫停播放語音

wx.stopVoice結束播放語音

wx.getBackgroundAudioPlayerState獲取音樂播放狀態

wx.playBackgroundAudio播放音樂

wx.pauseBackgroundAudio暫停播放音樂

wx.seekBackgroundAudio控制音樂播放進度

wx.stopBackgroundAudio停止播放音樂

wx.onBackgroundAudioPlay監聽音樂開始播放

wx.onBackgroundAudioPause監聽音樂暫停

wx.onBackgroundAudioStop監聽音樂結束

wx.chooseVideo從相冊選擇視頻,或者拍攝

3)文件API列表:

wx.saveFile保存文件

wx.getSavedFileList獲取已保存的文件列表

wx.getSavedFileInfo獲取已保存的文件信息

wx.removeSavedFile刪除已保存的文件信息

wx.openDocument打開文件

4)數據API列表:

wx.getStorage獲取本地數據緩存

wx.getStorageSync獲取本地數據緩存

wx.setStorage設置本地數據緩存

wx.setStorageSync設置本地數據緩存

wx.getStorageInfo獲取本地緩存的相關信息

wx.getStorageInfoSync獲取本地緩存的相關信息

wx.removeStorage刪除本地緩存內容

wx.removeStorageSync刪除本地緩存內容

wx.clearStorage清理本地數據緩存

wx.clearStorageSync清理本地數據緩存

5)位置API列表:

wx.getLocation獲取當前位置

wx.chooseLocation打開地圖選擇位置

wx.openLocation打開內置地圖

wx.createMapContext地圖組件控制

6)設備API列表:

wx.getNetworkType獲取網絡類型

wx.onNetworkStatusChange監聽網絡狀態變化

wx.getSystemInfo獲取系統信息

wx.getSystemInfoSync獲取系統信息

wx.onAccelerometerChange監聽加速度數據

wx.startAccelerometer開始監聽加速度數據

wx.stopAccelerometer停止監聽加速度數據

wx.onCompassChange監聽羅盤數據

wx.startCompass開始監聽羅盤數據

wx.stopCompass停止監聽羅盤數據

wx.setClipboardData設置剪貼板內容

wx.getClipboardData獲取剪貼板內容

wx.makePhoneCall撥打電話

wx.scanCode掃碼

7)界面API列表:

wx.showToast顯示提示框

wx.showLoading顯示加載提示框

wx.hideToast隱藏提示框

wx.hideLoading隱藏提示框

wx.showModal顯示模態彈窗

wx.showActionSheet顯示菜單列表

wx.setNavigationBarTitle設置當前頁面標題

wx.showNavigationBarLoading顯示導航條加載動畫

wx.hideNavigationBarLoading隱藏導航條加載動畫

wx.navigateTo新窗口打開頁面

wx.redirectTo原窗口打開頁面

wx.switchTab切換到tabbar頁面

wx.navigateBack退回上一個頁面

wx.createAnimation動畫

wx.createContext創建繪圖上下文

wx.drawCanvas繪圖

wx.stopPullDownRefresh停止下拉刷新動畫

8WXML節點信息API列表:

wx.createSelectorQuery創建查詢請求

selectorQuery.select根據選擇器選擇單個節點

selectorQuery.selectAll根據選擇器選擇全部節點

selectorQuery.selectViewport選擇顯示區域

nodesRef.boundingClientRect獲取布局位置和尺寸

nodesRef.scrollOffset獲取滾動位置

nodesRef.fields獲取任意字段

selectorQuery.exec執行查詢請求

9)開放接口:

wx.login登錄

wx.getUserInfo獲取用戶信息

wx.chooseAddress獲取用戶收貨地址

wx.requestPayment發起微信支付

wx.addCard添加卡券

wx.openCard打開卡券

3、相關處理代碼

1)注冊程序處理代碼

App({

onLaunch: function(options) {

// Do something initial when launch.? },

onShow: function(options) {

// Do something when show.? },

onHide: function() {

// Do something when hide.? },

onError: function(msg) {

console.log(msg)

},

globalData: 'I am global data'

})

2)注冊頁面處理代碼

//index.jsPage({

data: {

text: "This is page data."

},

onLoad: function(options) {

// Do some initialize when page load.? },

onReady: function() {

// Do something when page ready.? },

onShow: function() {

// Do something when page show.? },

onHide: function() {

// Do something when page hide.? },

onUnload: function() {

// Do something when page close.? },

onPullDownRefresh: function() {

// Do something when pull down.? },

onReachBottom: function() {

// Do something when page reach bottom.? },

onShareAppMessage: function () {

// return custom share data when user share.? },

onPageScroll: function() {

// Do something when page scroll? },

// Event handler.

viewTap: function() {

this.setData({

text: 'Set some data for updating view.'

})

},

customData: {

hi: 'MINA'

}

})

3JS函數模塊化

// common.jsfunction sayHello(name) {

console.log(`Hello ${name} !`)

}function sayGoodbye(name) {

console.log(`Goodbye ${name} !`)

}

module.exports.sayHello = sayHello

exports.sayGoodbye = sayGoodbye

在需要使用這些模塊的文件中,使用require(path)將公共代碼引入

var common = require('common.js')

Page({

helloMINA: function() {

common.sayHello('MINA')

},

goodbyeMINA: function() {

common.sayGoodbye('MINA')

}

})

4)網絡數據請求處理代碼

//點擊搜索按鈕調用的函數? ? ? search:function(e){

var that = this;

//數據加載完成之前,顯示加載中提示框? ? ? ? wx.showToast({

title: '加載中。。。',

icon: 'loading',

duration: 10000

});

//發起請求,注意 wx.request發起的是 HTTPS 請求? ? ? ? wx.request({

url: url + "?city=" + that.data.inputValue + "&key=" + apiKey,

data: {},

header: {

'content-type': 'application/json'

},

success: function(res) {

var data = res.data;

//將數據從邏輯層發送到視圖層,同時改變對應的 this.data 的值? ? ? ? ? ? that.setData({

restation: data.result,

condition: false

});

//數據加載成功后隱藏加載中彈框? ? ? ? ? ? wx.hideToast();

}

})

}

最后編輯于
?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。

推薦閱讀更多精彩內容

  • 微信小程序在無論在功能、文檔及相關支持方面,都是優于前面幾種微信賬號類型,它提供了很多原生程序才有的接口,使得我們...
    伍華聰_開發框架閱讀 1,626評論 0 53
  • 轉載請注明出處, 謝謝! (~ o ~)Y 1月9日,也就是今天,微信推出的“小程序”正式上線。“小程序”是一種無...
    Jimmy_P閱讀 14,448評論 52 273
  • 最近做了一個投票的微信小程序,開發過程主要還是參考官方文檔:https://mp.weixin.qq.com/de...
    june5253閱讀 22,059評論 1 11
  • 昨天看了一下微信小程序官方文檔,總結一下自己學習的個人心得. 首先從官方文檔給的框架說起,微信小程序官方文檔給出了...
    Mr大大大閱讀 47,244評論 9 68
  • 我是一個小丑。 我穿著五顏六色的服裝,戴著小丑面具,穿梭在繁華的商場、游樂場、鬧市的大街小巷。我能把氣球折成各種各...
    樂小哈閱讀 518評論 0 0