小程序模板網(wǎng)

小程序踩坑之旅

發(fā)布時間:2020-05-15 10:15 所屬欄目:小程序開發(fā)教程

最近幾個月因為公司的業(yè)務(wù)需求,一直在折騰小程序,從開始的完全不熟悉,到后面被各種坑折磨,是時候?qū)懸黄偨Y(jié)了,避免下一次遇到還找不到解決的方案。

配置項app.json和page.json

app.json

首先,需要確定的是,app.json 是小程序的全局配置,放在根目錄下。

常用的一些字段如下:

  • pages: 這個用于設(shè)置頁面的路徑,通常訪問的頁面都放在pages文件夾里面,且必須在這個全局配置文件中設(shè)置好路徑,否則訪問的時候會報錯找不到該路徑, 寫在 pages 字段的第一個頁面就是這個小程序的首頁 (打開小程序看到的第一個頁面)
  • window: 全局樣式的配置
    • 導(dǎo)航欄相關(guān):可配置導(dǎo)航欄背景顏色、標(biāo)題顏色,標(biāo)題內(nèi)容,
    • 可以隱藏導(dǎo)航欄(navigationStyle設(shè)置為custom,但需要注意, 自定義導(dǎo)航欄仍然保留右上角膠囊,且沒有返回鍵,如果想要實現(xiàn)返回功能,需要自己自定義返回的樣式和功能 ),==該設(shè)置對web-view 組件無效==
    • 窗口的背景色, backgroundColor,(即小程序下拉時露出的那一截),另外,僅ios支持的還有backgroundColorTop和backgroundColorBottom, 頂部和底部窗口的背景色
    • 下拉loading的樣式,只有黑色和白色(dark / light)
    • enablePullDownRefresh ,小程序默認頁面是沒有下拉刷新功能的,如果在app.json中配置該項為true,則所有頁面都可以生效。如果只想在單個頁面使用下拉刷新,需要在對應(yīng)的page.json中進行配置
    • onReachBottomDistance, 上拉加載更多生效時距頁面底部距離,默認為50px
    • 屏幕旋轉(zhuǎn),pageOrientation, 暫時還沒有用到過,支持 auto / portrait / landscape,默認為portrait豎屏顯示,
  • tabbar: tab欄設(shè)置
    • 位置:支持頂部和底部(通常使用底部tab欄), position(bottom / top)
    • tab列表 list: 文字以及對應(yīng)的路徑
      • 最少2個,最多5個
      • pagePath,頁面路徑(必須是pages中定義的路徑)
      • text, tab上的文字
      • iconPath, 圖片路徑,( 大小限制為 40kb,建議尺寸為 81px * 81px,不支持網(wǎng)絡(luò)圖片 )
      • selectedIconPath,選中時的圖片路徑。限制同上
    • 樣式相關(guān):color字體顏色,selectedColor選中文字的顏色,backgroundColor是tab欄背景色 ,borderStyle上邊框顏色,
    • custom是否自定義,默認為否, 具體文檔參考: 自定義tabBar
  • networkTimeout(設(shè)置網(wǎng)絡(luò)請求的超時時間)
    • request
    • connectSocket
    • uploadFile
    • downloadFile
  • debug, 開啟調(diào)試,會輸出Page 的注冊,頁面路由,數(shù)據(jù)更新,事件觸發(fā)等信息,方便查看生命周期的調(diào)試
  • navigateToMiniProgramAppIdList, 跳轉(zhuǎn)到其他小程序時,需要先在app.json中進行聲明
  • usingComponents,如果在app.json中聲明該組件,則全局可以使用該自定義組件,不需要再在page的json中聲明
  • permission, 用于授權(quán)相關(guān),平時項目中是自己寫的頁面,調(diào)用button的open-type屬性喚起授權(quán),其實可以通過插件功能頁來實現(xiàn),比如授權(quán)昵稱, 用戶信息功能頁

page.json

頁面的樣式配置優(yōu)先級比全局配置中的window高。

  • 可以設(shè)置導(dǎo)航欄背景顏色、導(dǎo)航欄標(biāo)題顏色,導(dǎo)航欄標(biāo)題,
  • 可以隱藏導(dǎo)航欄,custom 自定義導(dǎo)航欄,只保留右上角膠囊按鈕
  • 窗口的背景色 , 以及ios支持頂部和底部窗口的背景色
  • backgroundTextStyle,下拉 loading 的樣式,僅支持 dark / light
  • enablePullDownRefresh開啟下拉刷新,這個屬性只控制當(dāng)前的page頁面可以刷新
  • onReachBottomDistance,上拉加載更多生效時距頁面底部距離,默認為50px
  • pageOrientation,屏幕旋轉(zhuǎn)設(shè)置
  • disableScroll ,為 true 則頁面整體不能上下滾動。只在頁面配置中有效,無法在 app.json 中設(shè)置
  • disableSwipeBack, 禁止頁面右滑手勢返回
  • usingComponents, 使用自定義組件,如果沒有在頁面的json中聲明,直接使用組件會報錯

sitemap.json文件(用于微信索引)

默認規(guī)則為都默認被索引:

{"action": "allow", "page": "*"}

語法區(qū)別

wxml文件跟html的區(qū)別:

  • 沒有div, p, span, 使用view代替div, text代替span
  • wx:if的使用同vue中的v-if, 但使用上略有區(qū)別,不管在標(biāo)簽中還是文本上,都是使用雙大括號來表示插值, wx:for="{{array}}" ,
  • 條件渲染有wx:if, wx:elif, wx:else, 使用方式: <view wx:if="{{view == 'WEBVIEW'}}"> WEBVIEW </view>
  • 尤其注意,如果是使用boolean類型的值,不要直接在雙引號內(nèi)直接寫,也需要寫在雙大括號里面。如 <checkbox checked="{{false}}"> </checkbox>
  • 列表渲染 wx:for="{{array}}" , 可直接使用item和index,也可以使用 wx:for-item="idx" , 和 wx:for-item="itemName" 重新指定index和item的key值, 花括號和引號之間如果有空格,將最終被解析成為字符串
  • wxml文件中有一個標(biāo)簽是block, 僅僅是一個包裝元素,不會在頁面中做任何渲染,只接受控制屬性
  • wx:key的值只能是字符串或者 "*this", wx:key="*this" 表示for 循環(huán)中的 item 本身, 但是要保證這個item本身是一個唯一的字符串或者數(shù)字, 當(dāng)key綁定的是對象的時候會報錯

問題思考?

wx:if 和 hidden 該怎么合理的判斷使用場景?

  • wx:if 是惰性的,只有為true時才會局部渲染,當(dāng) wx:if 的條件值切換時,條件塊會在切換時銷毀或重新渲染。
  • 而hidden始終會被渲染,只是控制顯示與隱藏
  • 所以,如果需要頻繁切換的情景下,用 hidden 更好,如果在運行時條件不大可能改變則 wx:if 較好

組件

基礎(chǔ)組件

  • 組件的公共屬性:
    • id, class, style, hidden, data- , bind /catch*
  • 視圖容器:
    • 可移動: movable-area, movable-view。 其中,movable-view必須在 movable-area 組件中,并且必須是直接子節(jié)點
    • 覆蓋原生組件:cover-view, cover-image,主要用于覆蓋 map、video、canvas、camera、live-player、live-pusher等級別高的原生組件。 注意,在cover-view中只能嵌套cover-view、cover-image和button
    • 可滾動的視圖區(qū)域:scroll-view, 豎向滾動時,需要給scroll-view一個固定高度
    • 滑塊視圖容器: swiper, 其中只能放置swiper-item組件(常用于輪播圖)
    • 視圖容器view, 如果想使用hover的樣式,可以指定按下去的樣式類,跟hover相關(guān)的屬性: hover-class,hover-stop-propagation, hover-start-time, hover-stay-time
  • 圖標(biāo)icon,在小程序中可以使用自帶的一些icon圖標(biāo),可以設(shè)置type、大小、顏色,詳情查看, 小程序icon組件
  • 進度條,progress, 普通的進度條包括動畫等可以直接使用該組件
  • 富文本,rich-txt, (可以使用該組件渲染html內(nèi)容,傳入html字符串)
  • 文本,text, (如果需要展示多個空格,可以設(shè)置space屬性)
  • 按鈕,button,(可以設(shè)置disabled屬性進行禁用,防止多次點擊觸發(fā)事件)
  • 單選、多選框:radio、radio-goup、checkbox、checkbox-group
  • 富文本編輯器,editor
  • 表單form,支持switch input checkbox slider radio picker 的提交
  • 輸入框input,支持文本、數(shù)字、身份證、帶小數(shù)點的數(shù)字鍵盤等4個類型,password可以顯示密碼類型,(可以控制鍵盤右下角的文字,使用confirm-type屬性控制,包括“發(fā)送”、“搜索”、“下一個”、“前往”、“完成”)注意:input無法設(shè)置 font-family,使用的是系統(tǒng)字體
  • 滾動選擇器,picker,支持普通、多列、時間、日期、省市選擇器,
  • 嵌入頁面的滾動選擇器, picker-view, picker-view-column
  • 滑動選擇器,slider,類似進度條不過可以拖動
  • 開關(guān),switch
  • 多行輸入框,textarea
  • 導(dǎo)航,navigator,(類似于a標(biāo)簽,可以使用navigate、redirect、switchTab、reLaunch、navigateBack、exit(退出小程序)等類型)
  • 系統(tǒng)相機,camera,可以用于掃描二維碼
  • 視頻video,(注意,使用video組件在列表中的時候會引起小程序頁面卡頓甚至崩潰,目前項目中的解決方案是使用阿里云上傳視頻的截幀圖片來替換掉video組件,只有點擊圖片后才會播放視頻,查看網(wǎng)上資料說是video的src默認為空,解決了viode自動下載的bug,使用custom-cache="{{false}}"可以解決視頻緩存中卡住的問題,不過還沒有試過)
  • 公眾號關(guān)注組件,official-account
  • 承載網(wǎng)頁的容器,web-view,(適用于第三方網(wǎng)站內(nèi)容的嵌入,注意需要在公眾平臺配置業(yè)務(wù)域名),避免在鏈接中帶有中文字符,在 iOS中會有打開白屏的問題,建議加一下encodeURIComponent

原生組件的使用限制

  • 原生組件包括:
    • camera
    • canvas
    • input(僅在focus時表現(xiàn)為原生組件)
    • live-player
    • live-pusher
    • map
    • textarea
    • video
  • 層級: 最高,其他組件無論設(shè)置 z-index 為多少,都無法蓋在原生組件上
  • 原生組件不能設(shè)置動畫、fixed布局、不能使用overflow: hidden來裁剪原生組件的顯示區(qū)域,
  • 事件監(jiān)聽不能使用 bind:eventname 的寫法,只支持 bindeventname,不支持 catch 和 capture 的事件綁定方式

事件系統(tǒng)

  • 事件處理函數(shù),參數(shù)是event,event的事件內(nèi)容包括:

    • type
    • timeStamp, 事件生成時的時間戳
    • target,觸發(fā)事件的 源組件
    • currentTarget,事件綁定的 當(dāng)前組件
    • detail, 自定義事件所攜帶的數(shù)據(jù)
    • touches,一個數(shù)組,每個元素為一個 Touch 對象
    • changedTouches, 有變化的觸摸點
  • dataset:在target或currentTarget的事件對象中,可以通過dataset獲取當(dāng)前自定義的一些數(shù)據(jù),(在JS文件中使用event.currentTarget.dataset時,dataset的屬性會自動轉(zhuǎn)換字符串, 連字符寫法會轉(zhuǎn)換成駝峰寫法,而大寫字符會自動轉(zhuǎn)成小寫字符 )

  • mark,類似于dataset,(如果存在同名的 mark ,父節(jié)點的 mark 會被子節(jié)點覆蓋)

  • 頁面的用戶行為:

    • 下拉刷新 onPullDownRefresh
    • 上拉觸底 onReachBottom
    • 頁面滾動 onPageScroll
    • 用戶轉(zhuǎn)發(fā) onShareAppMessage

思考:

  1. 小程序中bind事件和catch事件有什么區(qū)別?
  • bind事件綁定不會阻止冒泡事件向上冒泡,
  • catch事件綁定可以阻止冒泡事件向上冒泡
  1. target和currentTarget有什么不同?
<view id="outer" bindtap="handleTap1">
  outer view
  <view id="middle" catchtap="handleTap2">
    middle view
    <view id="inner" bindtap="handleTap3">
      inner view
    </view>
  </view>
</view>
復(fù)制代碼

如上面這個示例中,點擊inner view會觸發(fā)handleTap3,同時會冒泡到handleTap2。 對于handleTap2這個組件來說,此時收到事件對象的target就是inner的元素,而currentTarget是middle的部分

  1. mark 和 dataset 有什么區(qū)別?
  • mark 會包含從觸發(fā)事件的節(jié)點到根節(jié)點上所有的 mark: 屬性值;
  • dataset 僅包含一個節(jié)點的 data- 屬性值
  • 節(jié)點的 mark 不會做連字符和大小寫轉(zhuǎn)換

小程序相關(guān)機制

  • 小程序框架的邏輯層并非運行在瀏覽器中,因此 JavaScript 在 web 中一些能力都無法使用,如 window,document 等

小程序的運行機制:冷啟動和熱啟動

  • 冷啟動: 首次打開小程序;或小程序銷毀后打開。(冷啟動會觸發(fā)app.js中的onLaunch生命周期函數(shù))
  • 熱啟動: 點擊右上角膠囊退出、或者home鍵離開微信、或者左右滑動返回到微信等動作,都是熱啟動,并沒有銷毀小程序,(所以熱啟動不會觸發(fā)onLaunch函數(shù),但會觸發(fā)onShow函數(shù))

啟動場景

  • 小程序啟動場景分為兩種:
    • 從發(fā)現(xiàn)欄、另一個小程序返回、微信支付、首頁下拉小程序欄等為A場景
    • B場景:打開某個特定頁面:如轉(zhuǎn)發(fā)分享的卡片鏈接
  • 熱啟動場景效果:
    1. 如果重新進入的場景和退出時的場景都是A場景,則保留原來狀態(tài);例如:停留在“個人中心”頁面,退出后,下拉首頁的小程序列表進入后還是會停留在“個人中心”頁面,(觸發(fā)“個人中心”Page的onShow函數(shù),但是不會觸發(fā)onLoad函數(shù))
    2. 如果當(dāng)前是A場景,上一個是B場景,則清空原來的頁面棧,打開首頁(即執(zhí)行 wx.reLaunch 到首頁)如分享出去的卡片是“學(xué)員列表”頁面,點擊卡片停留后退出,再從首頁下拉的小程序進入,此時會跳轉(zhuǎn)到首頁
    3. 不管上一個場景是什么,如果當(dāng)前是B場景,如點擊小程序的分享卡片,此時會清空原來的頁面棧,重新進入這個分享頁,首先觸發(fā)app中的onShow函數(shù),然后觸發(fā)這個分享頁的onLoad函數(shù),當(dāng)然如果app中已經(jīng)進行了跳轉(zhuǎn)到其它頁面,則不會再走這個分享頁。
  • 冷啟動場景效果:
    • 冷啟動規(guī)則比較簡單,如果冷啟動時是A場景,則進入小程序首頁
    • 如果冷啟動時是B場景,則進入對應(yīng)的特定頁面

更新機制

  • 小程序首先會在后臺有一個最新版本,一般來說會在24小時內(nèi)下發(fā)新版本信息到用戶,靜默更新到新版本(此時用戶是無感知態(tài))
  • 在后臺還沒及時更新版本時,每次冷啟動都會檢測是否有更新版本,如果有,會 異步下載 ,同時啟動當(dāng)前的舊版本包,所以新版本需要下一次的冷啟動才會應(yīng)用上
  • 如果啟動時就想立刻獲取最新版本,需要使用 wx.getUpdateManager 的API,用wx.showModal提示用戶是否重啟應(yīng)用更新

ES6的支持情況:

  • 微信小程序已經(jīng)支持了絕大部分的 ES6 API,但部分API仍依賴于系統(tǒng)版本而不支持
  • String的normalize在ios8,ios9不支持
  • 數(shù)組的values在ios8和android不支持
  • 數(shù)組的includes在ios8不支持
  • Proxy不支持ios8、ios9和android

注冊小程序

  • app.js中注冊小程序,整個小程序只有一個 App 實例,是全部頁面共享的。
  • 開發(fā)者可以通過 getApp 方法獲取到全局唯一的 App 示例,獲取App上的數(shù)據(jù)或調(diào)用開發(fā)者注冊在 App 上的函數(shù)
  • 在app.js中可以直接使用this.globalData賦值,但在其他頁面需通過getApp()方法獲取到實例后才能使用全局變量globalData
App({
  onLaunch: function(options) {},
  onShow: function(options) {},
  onHide: function() {},
  onError: function(msg) {},
  globalData: 'I am global data'
})
復(fù)制代碼

注冊頁面和自定義組件

頁面

  • data 是頁面第一次渲染使用的初始數(shù)據(jù)
  • onLoad頁面加載時觸發(fā)。一個頁面只會調(diào)用一次;
  • onShow在頁面顯示/切入前臺時觸發(fā)
  • onPageScroll,監(jiān)聽用戶滑動頁面事件,( 請避免在 onPageScroll 中過于頻繁的執(zhí)行 setData 等引起邏輯層-渲染層通信的操作。尤其是每次傳輸大量數(shù)據(jù),會影響通信耗時 )
  • onShareAppMessage監(jiān)聽頁面內(nèi)的轉(zhuǎn)發(fā),轉(zhuǎn)發(fā)有button 組件 open-type="share"和右上角轉(zhuǎn)發(fā)兩個方式,(只有Page中定義了onShareAppMessage,右上角才會出現(xiàn)轉(zhuǎn)發(fā)功能)
  • setData:
    • 將數(shù)據(jù)從邏輯層發(fā)送到視圖層(異步),同時改變對應(yīng)的 this.data 的值(同步)(跟react的setState類似,但又不一樣)
    • 直接修改 this.data 而不調(diào)用 this.setData 是無法改變頁面的狀態(tài)的,還會造成數(shù)據(jù)不一致
    • 不要把 data 中任何一項的 value 設(shè)為 undefined
    • 如果需要視圖層更新完畢后再處理事件,可以將事件放在setData的回調(diào)函數(shù)中

Page構(gòu)造器:

Page({
  data: { text: "This is page data." },
  onLoad: function(options) { },
  onReady: function() { },
  onShow: function() { },
  onHide: function() { },
  onUnload: function() { },
  onPullDownRefresh: function() { },
  onReachBottom: function() { },
  onShareAppMessage: function () { },
  onPageScroll: function() { }
})
復(fù)制代碼

自定義組件

  • 頁面使用自定義組件時需要現(xiàn)在page的json文件中聲明usingComponents定義段
  • 組件使用頁面的生命周期方法時(即 on 開頭的方法),應(yīng)該寫在methods定義段中
  • behaviors 提取所有頁面中公用的代碼段,例如, 在所有頁面被創(chuàng)建和銷毀時都要執(zhí)行同一段代碼,就可以把這段代碼提取到 behaviors 中
// page-common-behavior.js
module.exports = Behavior({
  attached: function() {
    // 頁面創(chuàng)建時執(zhí)行
    console.info('Page loaded!')
  },
  detached: function() {
    // 頁面銷毀時執(zhí)行
    console.info('Page unloaded!')
  }
})


// 頁面 A
var pageCommonBehavior = require('./page-common-behavior')
Component({
  behaviors: [pageCommonBehavior],
  data: { /* ... */ },
  methods: { /* ... */ },
})


// 頁面 B
var pageCommonBehavior = require('./page-common-behavior')
Component({
  behaviors: [pageCommonBehavior],
  data: { /* ... */ },
  methods: { /* ... */ },
})
復(fù)制代碼
  • 在 properties 定義段中,屬性名采用駝峰寫法(propertyName);在 wxml 中,指定屬性值時則對應(yīng)使用連字符寫法(component-tag-name property-name="attr value"),應(yīng)用于數(shù)據(jù)綁定時采用駝峰寫法(attr="")
  • observers數(shù)據(jù)監(jiān)聽器,(類似于vue中的watch),具體請參考 數(shù)據(jù)監(jiān)聽器
  • created,組件實例剛被創(chuàng)建,( 注意此時不能調(diào)用 setData )
  • definitionFilter,定義段過濾器,用于自定義組件擴展(如擴展自定義組件一個computed計算屬性功能)

注意:

  • 使用 this.data 可以獲取內(nèi)部數(shù)據(jù)和屬性值;但直接修改它不會將變更應(yīng)用到界面上,應(yīng)使用 setData 修改
  • 生命周期函數(shù)無法在組件方法中通過 this 訪問到

組件間的通信與事件

  • 父傳子:父組件綁定屬性值,子組件通過properties獲取,
  • 子組件向父組件傳遞數(shù)據(jù):使用事件傳遞
  • 父組件訪問子組件: 父組件可以通過 this.selectComponent 方法獲取子組件實例對象,這樣就可以直接訪問組件的任意數(shù)據(jù)和方法

此處列舉第二種自定義事件傳遞數(shù)據(jù)的方法:

// 1. 父組件中監(jiān)聽事件
<component-tag-name bindmyevent="onMyEvent" />

// 2. 子組件觸發(fā)事件,觸發(fā)wxml的onMyEvent事件,觸發(fā)父組件的方法
<!--自定義組件中-->
<button bindtap="onTap">點擊這個按鈕將觸發(fā)“myevent”事件</button>

<!--自定義組件js文件中-->
Component({
  properties: {},
  methods: {
    onTap: function(){
      var myEventDetail = {} // detail對象,提供給事件監(jiān)聽函數(shù)
      var myEventOption = {} // 觸發(fā)事件的選項
      this.triggerEvent('myevent', myEventDetail, myEventOption)
    }
  }
})

復(fù)制代碼

具體可參考文檔: 組件間通信與事件

注意:

  • 組件和引用組件的頁面不能使用id選擇器(#a)、屬性選擇器([a])和標(biāo)簽名選擇器,請改用class選擇器
  • 避免使用后代選擇器(.a .b)
  • 子元素選擇器(.a>.b)只能用于 view 組件與其子節(jié)點之間,用于其他組件可能導(dǎo)致非預(yù)期的情況
  • app.wxss 中的樣式、組件所在頁面的的樣式對自定義組件無效(除繼承樣式外,如 font 、 color會繼承自組件外)

組件間關(guān)系

場景: 如果一個頁面中需要使用到A組件和B組件,而A組件與B組件之間需要通信,此時可以在組件定義時加入relations定義段,如封裝的ul和li組件后,之間需要存在關(guān)聯(lián)的父子關(guān)系

  • 必須在兩個組件定義中都加入relations定義,否則不會生效
  • type,與目標(biāo)組件的相對關(guān)系,可選的值為 parent 、 child 、 ancestor 、 descendant
  • 另一種情況是關(guān)聯(lián)一類組件(如form與input、checkbox等的關(guān)系),需要使用到behavior

具體使用方式參見 組件間關(guān)系

使用setData應(yīng)注意的事項:

  • 不要頻繁的去 setData,否則可能導(dǎo)致Android 下用戶在滑動時會感覺到卡頓,或者渲染有出現(xiàn)延時
  • 不要每次 setData 都傳遞大量新數(shù)據(jù)
  • 不要在后臺態(tài)頁面進行 setData ,

小程序運行流程

  1. 微信打開小程序前,會把整個小程序的代碼包下載到本地
  2. 通過 app.json 的 pages 字段就可以知道你當(dāng)前小程序的所有頁面路徑
  3. 寫在 pages 字段的第一個頁面就是這個小程序的首頁(打開小程序看到的第一個頁面),所以微信會把首頁的代碼裝載進來
  4. 小程序啟動,觸發(fā)app.js 定義的 App 實例的 onLaunch回調(diào),啟動時也會觸發(fā)onShow函數(shù),或切前臺、從其他頁面返回到這個頁面,都會觸發(fā)onShow;onHide監(jiān)聽小程序切后臺,(如tab切換,navigateTo,離開微信等); onPageNotFound頁面不存在監(jiān)聽函數(shù)
  5. 頁面的渲染流程開始,微信客戶端會先根據(jù) page的json文件配置生成一個界面,
  6. 接著裝載這個頁面的 WXML 結(jié)構(gòu)和 WXSS 樣式
  7. 最后客戶端會裝載 page的js文件
  8. Page構(gòu)造器會生成一個頁面,生成頁面的時候小程序框架會把 data 數(shù)據(jù)和 index.wxml 一起渲染出最終的結(jié)構(gòu),渲染完界面
  9. 渲染完界面之后,頁面實例就會收到一個 onLoad 的回調(diào)

生命周期函數(shù)

小程序里面又三種生命周期:小程序運行的生命周期(在app.js中處理),頁面的生命周期(在page的js文件中處理,或者組件的pageLifetimes觸發(fā)的生命周期函數(shù)),組件的生命周期

小程序生命周期函數(shù)

  • onLaunch, 小程序初始化完成時觸發(fā),全局只觸發(fā)一次
  • onShow,小程序啟動,或從后臺進入前臺顯示時觸發(fā)
  • onHide,從前臺進入后臺時觸發(fā)
  • onError,小程序發(fā)生腳本錯誤或 API 調(diào)用報錯時觸發(fā)
  • onPageNotFound,小程序要打開的頁面不存在時觸發(fā)

onLaunch,onShow參數(shù):

  • path: 打開小程序的頁面路徑
  • query: 打開小程序的頁面參數(shù)query
  • scene: 打開小程序的場景值,
  • shareTicket: 轉(zhuǎn)發(fā)分享參數(shù)
  • referrerInfo:當(dāng)場景為由從另一個小程序或公眾號或App打開時,返回此字段
  • referrerInfo.appId: 來源小程序或公眾號或App的 appId
  • referrerInfo.extraData: 來源小程序傳過來的數(shù)據(jù),scene=1037或1038時支持

頁面生命周期函數(shù)

  • onLoad,監(jiān)聽頁面加載
  • onShow, 監(jiān)聽頁面顯示(如tab切換或者離開微信、或navigateTo)
  • onReady, 監(jiān)聽頁面初次渲染完成(一個頁面只會調(diào)用一次,代表頁面已經(jīng)準(zhǔn)備妥當(dāng))
  • onHide, 監(jiān)聽頁面隱藏, (如 wx.navigateTo 或底部 tab 切換到其他頁面,小程序切入后臺等)
  • onUnload, 監(jiān)聽頁面卸載(如wx.redirectTo或wx.navigateBack到其他頁面時)

組件生命周期函數(shù)

  • created,在組件實例剛剛被創(chuàng)建時執(zhí)行,注意此時不能調(diào)用 setData
  • attached,在組件實例進入頁面節(jié)點樹時執(zhí)行
  • ready,在組件布局完成后執(zhí)行
  • moved, 在組件實例被移動到節(jié)點樹另一個位置時執(zhí)行
  • detached, 在組件實例被從頁面節(jié)點樹移除時執(zhí)行

注意:

組件中存在一個組件所在頁面的生命周期,定義在pageLifetimes中,其中可用的生命周期包括:

  • show, 組件所在的頁面被展示時執(zhí)行
  • hide, 組件所在的頁面被隱藏時執(zhí)行
  • resize, 組件所在的頁面尺寸變化時執(zhí)行

網(wǎng)絡(luò)

  1. 服務(wù)器域名配置,當(dāng)使用體驗版或者開發(fā)版報“服務(wù)器開小差”了的錯誤,大部分可能性都是因為沒有打開調(diào)試,因為在調(diào)試模式下,小程序不會去校驗域名的合法性。
  2. 小程序只可以跟指定的域名與進行網(wǎng)絡(luò)通信,包括普通 HTTPS 請求(wx.request)、上傳文件(wx.uploadFile)、下載文件(wx.downloadFile) 和 WebSocket 通信(wx.connectSocket)
  3. 如果接入第三方網(wǎng)頁,使用web-view組件,需要配置業(yè)務(wù)域名
  4. 默認超時時間為60s,超時時間可以在 app.json 或 game.json 中通過 networktimeout 配置
  5. 并發(fā)限制:wx.request、wx.uploadFile、wx.downloadFile 的最大并發(fā)限制是 10 個;wx.connectSockt 的最大并發(fā)限制是 5 個
  6. 返回狀態(tài),只要成功接收到服務(wù)器返回, 無論 statusCode 是多少,都會進入 success 回調(diào)

自定義tabBar

用戶可以通過配置app.json 中的 tabBar 項指定 custom 字段為true,來自定義tabBar,不過有些使用地方還需要注意:

  1. tabBar 的相關(guān)配置項仍然需完整聲明,以兼容低版本以及區(qū)分哪些是tab頁
  2. 需要用戶自定義一個組件來渲染 tabBar,推薦用 fixed 在底部的 cover-view + cover-image 組件渲染樣式,以保證 tabBar 層級相對較高
  3. 與 tabBar 樣式相關(guān)的接口,如 wx.setTabBarItem 等將失效
  4. 可以在自定義組件下通過 getTabBar 接口,獲取當(dāng)前頁面的自定義 tabBar 組件實例

小程序登錄流程

小程序登錄需要調(diào)用微信的開放接口,整體流程如下:

  1. 小程序通過wx.login()獲取一個code
  2. 調(diào)用后端的api,發(fā)送code,后端通過這個code來校驗接口,并返回一個自定義登錄態(tài)
  3. 小程序?qū)⒌卿洜顟B(tài)存入storage
  4. 之后再訪問服務(wù)器發(fā)送業(yè)務(wù)請求就只用后端判斷登錄態(tài)查詢openid和session_key返回業(yè)務(wù)數(shù)據(jù)

小程序優(yōu)化操作

  1. 縮短白屏?xí)r間:
    • 首屏渲染的內(nèi)容較多,需要集合多份數(shù)據(jù)進行渲染:此時可以把優(yōu)先級高的內(nèi)容做優(yōu)先展示
    • 首屏內(nèi)容依賴的數(shù)據(jù)從服務(wù)端請求的時間太長:分析數(shù)據(jù)返回的時間長的原因
    • 一次性渲染數(shù)據(jù)太大或依賴的計算過于復(fù)雜:減少渲染的數(shù)據(jù)量、優(yōu)化渲染相關(guān)數(shù)據(jù)的算法
  2. 渲染界面的耗時過長,需要校驗下是否同時渲染的區(qū)域太大(例如列表過長)
  3. 腳本執(zhí)行時間過長:需要確認并優(yōu)化腳本的邏輯
  4. setData調(diào)用頻繁:避免無用的頻繁調(diào)用,每秒調(diào)用setData的次數(shù)不超過 20 次,
// 不要頻繁調(diào)用setData
    this.setData({ a: 1 })
    this.setData({ b: 2 })
// 絕大多數(shù)時候可優(yōu)化為
    this.setData({ a: 1, b: 2 })
復(fù)制代碼
  1. setData的數(shù)據(jù)太大,setData的數(shù)據(jù)在JSON.stringify后不超過 256KB
  2. setData一個未綁定的變量
// 不要設(shè)置不在界面渲染時使用的數(shù)據(jù),并將界面無關(guān)的數(shù)據(jù)放在data外
    this.setData({
      myData: {
        a: '這個字符串在WXML中用到了',
        b: '這個字符串未在WXML中用到,而且它很長…………………………'
      }
    })
    // 可以優(yōu)化為
    this.setData({
      'myData.a': '這個字符串在WXML中用到了'
    })
    this._myData = {
      b: '這個字符串未在WXML中用到,而且它很長…………………………'
    }

復(fù)制代碼
  1. 開啟 HTTP 緩存控制
  2. 控制WXML節(jié)點數(shù)
<view data-my-data="{{myData}}"> <!-- 這個 view 和下一行的 view 可以合并 -->
  <view class="my-class" data-my-data="{{myData}}" bindtap="onTap">
    <text> <!-- 這個 text 通常是沒必要的 -->
      {{myText}}
    </text>
  </view>
</view>

<!-- 可以簡化為 -->

<view class="my-class" data-my-data="{{myData}}" bindtap="onTap">
  {{myText}}
</view>
復(fù)制代碼
  1. 控制圖片大小,圖片寬高都不超過實際顯示寬高的3倍
  2. 合理控制網(wǎng)絡(luò)請求數(shù)量
  3. 控制圖片請求數(shù)
  4. 開啟慣性滾動:wxss中帶有overflow: scroll的元素,在 iOS 下需要設(shè)置-webkit-overflow-scrolling: touch樣式
  5. 避免使用:active偽類來實現(xiàn)點擊態(tài)
  6. 保持圖片大小比例
  7. 可點擊元素的寬高都不小于 20px
  8. iphoneX兼容,用以下wxss進行兼容:
padding-bottom: constant(safe-area-inset-bottom);
padding-bottom: env(safe-area-inset-bottom);
復(fù)制代碼
  1. 避免JS異常
  2. 不使用廢棄接口
  3. 設(shè)置最低基礎(chǔ)庫版本
  4. 移除不可訪問到的頁面
  5. 移除大量未使用的樣式
  6. 及時回收定時器:定時器是全局的,并不是跟頁面綁定的,當(dāng)小程序從一個頁面路由到另一個頁面之后,前一個頁面定時器應(yīng)注意手動回收


易優(yōu)小程序(企業(yè)版)+靈活api+前后代碼開源 碼云倉庫:starfork
本文地址:http://www.u-renovate.com/wxmini/doc/course/25179.html 復(fù)制鏈接 如需定制請聯(lián)系易優(yōu)客服咨詢:800182392 點擊咨詢
QQ在線咨詢
AI智能客服 ×