微信小程序開發(fā)基礎知識總結(jié)

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

1、小程序的目錄結(jié)構(gòu)

小程序的目錄結(jié)構(gòu)如下所示。

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

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

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

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

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

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

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

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

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

邏輯層(App Service)

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

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

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

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

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

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

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

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

視圖層

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

將邏輯層的數(shù)據(jù)反應成視圖,同時將視圖層的事件發(fā)送給邏輯層。

WXML(WeiXin Markup language)用于描述頁面的結(jié)構(gòu)。

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

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

基礎組件

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

什么是組件:

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

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

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

Content goes here ...

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

API

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

說明:

wx.on開頭的API是監(jiān)聽某個事件發(fā)生的API接口,接受一個CALLBACK函數(shù)作為參數(shù)。當該事件觸發(fā)時,會調(diào)用CALLBACK函數(shù)。

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

OBJECT中可以指定success,?fail,?complete來接收接口調(diào)用結(jié)果。

參數(shù)名

類型

必填

說明

success

Function

接口調(diào)用成功的回調(diào)函數(shù)

fail

Function

接口調(diào)用失敗的回調(diào)函數(shù)

complete

Function

接口調(diào)用結(jié)束的回調(diào)函數(shù)(調(diào)用成功、失敗都會執(zhí)行)

2、小程序接口功能列表

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

1)網(wǎng)絡API列表:

wx.request發(fā)起網(wǎng)絡請求

wx.uploadFile上傳文件

wx.downloadFile下載文件

wx.connectSocket創(chuàng)建WebSocket連接

wx.onSocketOpen監(jiān)聽WebSocket打開

wx.onSocketError監(jiān)聽WebSocket錯誤

wx.sendSocketMessage發(fā)送WebSocket消息

wx.onSocketMessage接受WebSocket消息

wx.closeSocket關閉WebSocket連接

wx.onSocketClose監(jiān)聽WebSocket關閉

2)媒體API列表:

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

wx.previewImage預覽圖片

wx.startRecord開始錄音

wx.stopRecord結(jié)束錄音

wx.playVoice播放語音

wx.pauseVoice暫停播放語音

wx.stopVoice結(jié)束播放語音

wx.getBackgroundAudioPlayerState獲取音樂播放狀態(tài)

wx.playBackgroundAudio播放音樂

wx.pauseBackgroundAudio暫停播放音樂

wx.seekBackgroundAudio控制音樂播放進度

wx.stopBackgroundAudio停止播放音樂

wx.onBackgroundAudioPlay監(jiān)聽音樂開始播放

wx.onBackgroundAudioPause監(jiān)聽音樂暫停

wx.onBackgroundAudioStop監(jiān)聽音樂結(jié)束

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

3)文件API列表:

wx.saveFile保存文件

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

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

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

wx.openDocument打開文件

4)數(shù)據(jù)API列表:

wx.getStorage獲取本地數(shù)據(jù)緩存

wx.getStorageSync獲取本地數(shù)據(jù)緩存

wx.setStorage設置本地數(shù)據(jù)緩存

wx.setStorageSync設置本地數(shù)據(jù)緩存

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

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

wx.removeStorage刪除本地緩存內(nèi)容

wx.removeStorageSync刪除本地緩存內(nèi)容

wx.clearStorage清理本地數(shù)據(jù)緩存

wx.clearStorageSync清理本地數(shù)據(jù)緩存

5)位置API列表:

wx.getLocation獲取當前位置

wx.chooseLocation打開地圖選擇位置

wx.openLocation打開內(nèi)置地圖

wx.createMapContext地圖組件控制

6)設備API列表:

wx.getNetworkType獲取網(wǎng)絡類型

wx.onNetworkStatusChange監(jiān)聽網(wǎng)絡狀態(tài)變化

wx.getSystemInfo獲取系統(tǒng)信息

wx.getSystemInfoSync獲取系統(tǒng)信息

wx.onAccelerometerChange監(jiān)聽加速度數(shù)據(jù)

wx.startAccelerometer開始監(jiān)聽加速度數(shù)據(jù)

wx.stopAccelerometer停止監(jiān)聽加速度數(shù)據(jù)

wx.onCompassChange監(jiān)聽羅盤數(shù)據(jù)

wx.startCompass開始監(jiān)聽羅盤數(shù)據(jù)

wx.stopCompass停止監(jiān)聽羅盤數(shù)據(jù)

wx.setClipboardData設置剪貼板內(nèi)容

wx.getClipboardData獲取剪貼板內(nèi)容

wx.makePhoneCall撥打電話

wx.scanCode掃碼

7)界面API列表:

wx.showToast顯示提示框

wx.showLoading顯示加載提示框

wx.hideToast隱藏提示框

wx.hideLoading隱藏提示框

wx.showModal顯示模態(tài)彈窗

wx.showActionSheet顯示菜單列表

wx.setNavigationBarTitle設置當前頁面標題

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

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

wx.navigateTo新窗口打開頁面

wx.redirectTo原窗口打開頁面

wx.switchTab切換到tabbar頁面

wx.navigateBack退回上一個頁面

wx.createAnimation動畫

wx.createContext創(chuàng)建繪圖上下文

wx.drawCanvas繪圖

wx.stopPullDownRefresh停止下拉刷新動畫

8WXML節(jié)點信息API列表:

wx.createSelectorQuery創(chuàng)建查詢請求

selectorQuery.select根據(jù)選擇器選擇單個節(jié)點

selectorQuery.selectAll根據(jù)選擇器選擇全部節(jié)點

selectorQuery.selectViewport選擇顯示區(qū)域

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

nodesRef.scrollOffset獲取滾動位置

nodesRef.fields獲取任意字段

selectorQuery.exec執(zhí)行查詢請求

9)開放接口:

wx.login登錄

wx.getUserInfo獲取用戶信息

wx.chooseAddress獲取用戶收貨地址

wx.requestPayment發(fā)起微信支付

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函數(shù)模塊化

// 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)網(wǎng)絡數(shù)據(jù)請求處理代碼

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

var that = this;

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

title: '加載中。。。',

icon: 'loading',

duration: 10000

});

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

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

data: {},

header: {

'content-type': 'application/json'

},

success: function(res) {

var data = res.data;

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

restation: data.result,

condition: false

});

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

}

})

}

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
平臺聲明:文章內(nèi)容(如有圖片或視頻亦包括在內(nèi))由作者上傳并發(fā)布,文章內(nèi)容僅代表作者本人觀點,簡書系信息發(fā)布平臺,僅提供信息存儲服務。
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市,隨后出現(xiàn)的幾起案子,更是在濱河造成了極大的恐慌,老刑警劉巖,帶你破解...
    沈念sama閱讀 228,786評論 6 534
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件,死亡現(xiàn)場離奇詭異,居然都是意外死亡,警方通過查閱死者的電腦和手機,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 98,656評論 3 419
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人,你說我怎么就攤上這事。” “怎么了?”我有些...
    開封第一講書人閱讀 176,697評論 0 379
  • 文/不壞的土叔 我叫張陵,是天一觀的道長。 經(jīng)常有香客問我,道長,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 63,098評論 1 314
  • 正文 為了忘掉前任,我火速辦了婚禮,結(jié)果婚禮上,老公的妹妹穿的比我還像新娘。我一直安慰自己,他們只是感情好,可當我...
    茶點故事閱讀 71,855評論 6 410
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著,像睡著了一般。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發(fā)上,一...
    開封第一講書人閱讀 55,254評論 1 324
  • 那天,我揣著相機與錄音,去河邊找鬼。 笑死,一個胖子當著我的面吹牛,可吹牛的內(nèi)容都是我干的。 我是一名探鬼主播,決...
    沈念sama閱讀 43,322評論 3 442
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了?” 一聲冷哼從身側(cè)響起,我...
    開封第一講書人閱讀 42,473評論 0 289
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后,有當?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體,經(jīng)...
    沈念sama閱讀 49,014評論 1 335
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點故事閱讀 40,833評論 3 355
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發(fā)現(xiàn)自己被綠了。 大學時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 43,016評論 1 371
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖,靈堂內(nèi)的尸體忽然破棺而出,到底是詐尸還是另有隱情,我是刑警寧澤,帶...
    沈念sama閱讀 38,568評論 5 362
  • 正文 年R本政府宣布,位于F島的核電站,受9級特大地震影響,放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜,卻給世界環(huán)境...
    茶點故事閱讀 44,273評論 3 347
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧,春花似錦、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 34,680評論 0 26
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至,卻和暖如春,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 35,946評論 1 288
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人。 一個月前我還...
    沈念sama閱讀 51,730評論 3 393
  • 正文 我出身青樓,卻偏偏與公主長得像,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當晚...
    茶點故事閱讀 48,006評論 2 374

推薦閱讀更多精彩內(nèi)容