整理于網(wǎng)絡 http://blog.poetries.top/2018/08/09/xiaochengxu-note

關注公眾號獲取更多資訊

一、小程序代碼組成

前言

• App() 必須在 app.js 中注冊挠轴，且不能注冊多個。
• 編譯后的代碼包大小需小于 2MB，否則代碼包將上傳失敗突照。
• 每個頁面需要手動在app.json中進行注冊，否則不能訪問氧吐。
• app.json中pages數(shù)組的第一項代表小程序的初始頁面讹蘑，小程序中新增/減少頁面，都需要對 pages 數(shù)組進行修改筑舅。
• 直接修改 this.data無效座慰，無法改變頁面的狀態(tài)，還會造成數(shù)據(jù)不一致翠拣。
• 單次設置的數(shù)據(jù)不能超過1024kB版仔，請盡量避免一次設置過多的數(shù)據(jù)。
• 不要嘗試修改頁面棧误墓，會導致路由以及頁面狀態(tài)錯誤邦尊。
• tabBar只能配置最少2個、最多5個优烧，tab 按數(shù)組的順序排序蝉揍。
• 小程序頁面只能同時打開 5 個，如果交互流程較長難以支持畦娄。
• 同時只能存在 5 個url請求又沾。
• 無法跳轉小程序以外的url。
• 沒有cookie熙卡。
• 沒有a標簽鏈接杖刷，不可嵌套iframe
• 沒有window變量，但微信提供了wx全局方法集
• 事件綁定和條件渲染類似Angular驳癌，全部寫在WXML中

1.1 主體

由app.js滑燃、app.json、app.wxss三個文件組成颓鲜，放在根目錄

• app.js 根目錄的app.js很有用,因為在它內部注冊的變量或方法表窘，都是可以被所有頁面獲取到典予。可以監(jiān)聽并處理小程序的生命周期乐严、聲明全局變量瘤袖。其余的.js文 件可以通過var app = getApp() 獲取其實例，調用其中定義的方法和變量昂验，但不可以調用生命周期的方法
• app.json是小程序的全局配置

pages 配置小程序的組成頁面捂敌，第一個代表小程序的初始頁面
window  設置小程序的狀態(tài)欄、標題欄既琴、導航條占婉、窗口背景顏色
tabBar  配置小程序tab欄的樣式和對應的頁面

• app.wxss 是小程序的公共樣式表，可以在其他.wxss文件中直接使用

app.json

"pages": [ //設置頁面的路徑
  "pages/index/index", //不需要寫index.wxml,index.js,index,wxss,框架會自動尋找并整合
  "pages/logs/logs"
],
"window": { //設置默認窗口的表現(xiàn)形式
  "navigationBarBackgroundColor": "#ffffff", //頂部導航欄背景色
  "navigationBarTextStyle": "black", //頂部導航文字的顏色 black/white
  "navigationBarTitleText": "微信接口功能演示", //頂部導航的顯示文字
  "backgroundColor": "#eeeeee", //窗口的背景色
  "backgroundTextStyle": "light", //下拉背景字體甫恩、loading 圖的樣式锐涯，僅支持 dark/light
  "enablePullDownRefresh": "false"， //是否支持下拉刷新 填物，不支持的話就直接不寫纹腌！
  "disableScroll": true, //  設置true不能上下滾動，true/false滞磺，注意升薯！只能在 page.json 中有效，無法在 app.json 中設置該項击困。
},
"tabBar": { //底部tab或者頂部tab的表現(xiàn)涎劈，是個數(shù)組，最少配置2個阅茶，最多5個
  "list": [{ //設置tab的屬性蛛枚，最少2個，最多5個
    "pagePath": "pages/index/index", //點擊底部 tab 跳轉的路徑
    "text": "首頁", //tab 按鈕上的文字
    "iconPath": "../img/a.png", //tab圖片的路徑
    "selectedIconPath": "../img/a.png" //tab 在當前頁脸哀，也就是選中狀態(tài)的路徑
  }, {
    "pagePath": "pages/logs/logs",
    "text": "日志"
  }],
  "color": "red", //tab 的字體顏色
  "selectedColor": "#673ab7", //當前頁 tab 的顏色蹦浦，也就是選中頁的
  "backgroundColor": "#2196f3", //tab 的背景色
  "borderStyle": "white", //邊框的顏色 black/white
  "position": "bottom" //tab處于窗口的位置 top/bottom
  },
"networkTimeout": { //默認都是 60000 秒一分鐘
    "request": 10000, //請求網(wǎng)絡超時時間 10000 秒
    "downloadFile": 10000， //鏈接服務器超時時間 10000 秒
      "uploadFile": "10000", //上傳圖片 10000 秒
    "downloadFile": "10000" //下載圖片超時時間 10000 秒
  },
"debug": true //項目上線后撞蜂，建議關閉此項盲镶，或者不寫此項

1.2 pages

pages文件夾里是小程序的各個頁面，每個界面一般都由.wxml蝌诡、.wxss溉贿、.js、.json四個文件組成浦旱，四個文件必須是相同的名字和路徑

• .js 是頁面的腳本代碼宇色，通過Page()函數(shù)注冊頁面。可以指定頁面的初始數(shù)據(jù)宣蠕、生命周期例隆、事件處理等
• .wxml 是頁面的布局文件，只能使用微信定義的組件
• .wxss 是樣式表植影，需要注意
  • 尺寸單位：rpx 可以根據(jù)屏幕的寬帶進行自適應
  • 樣式導入：@import導入外聯(lián)樣式表，如：@import "test.wxss";
  • 定義在app.wxss中的全局樣式涎永，作用于每個頁面思币。定義在page的.wxss文件只作用于對應的頁面，會覆蓋app.wxss中相同的選擇器
• .json 是頁面的配置文件羡微，只能設置app.json中的window配置內容谷饿，會覆蓋app.json中window的相同配置項，即使不配置任何東西也需要寫{},否則會報錯

1.3 utils

utils 里面包含一些公共的代碼抽取的js文件妈倔，作為模塊方便使用博投。模塊通過module.exports對外暴露接口

• 其他地方使用是var utils = require('../../utils/util.js') 進行引用

二、視圖層 WXML

2.1 數(shù)據(jù)綁定

傳統(tǒng)的視圖和數(shù)據(jù)綁定

image.png

那么微信小程序是通過什么方法來管理視圖和對象綁定的呢,狀態(tài)模式-單向數(shù)據(jù)流

image.png

數(shù)據(jù)流向是單向的盯蝴，即視圖變化不會影響對象狀態(tài)

• 用戶觸發(fā)事件不僅要考慮當前UI元素更新毅哗，還會通過當前元素更新其他視圖。
• 所以視圖上的數(shù)據(jù)都必須用過事件傳遞給對象捧挺，只有用戶操作視圖虑绵，才能獲取到數(shù)據(jù)，并更新對象狀態(tài)

image.png

.wxml 中的動態(tài)數(shù)據(jù)都來自Page中的data闽烙。數(shù)據(jù)綁定使用數(shù)據(jù)綁定使用雙大括號將變量包起來翅睛，可以作用于內容、組件屬性(需要在雙引號之內)黑竞、控制屬性(需要在雙引號之內)捕发、關鍵字(需要在雙引號之內)

Page({
    data: {
        message: "Hello",
        id:0,
        status: true
    }
})

<view> {{message}} </view>
<view id="item-{{id}}"> </view>
<view wx:if="{{status}}"> </view>
<view hidden="{{status}}"> </checkbox>

還可以進行簡單的運算在大括號里

<view hidden="{{status ? true : false}}"> Hidden </view>
<view> {{a + b}} + c </view> 
<view wx:if="{{num > 6}}"> </view>
<view>{{"hello" + word}}</view>

2.2 條件渲染

用 wx:if=”{{status}}”來判斷是否渲染代碼塊

<view wx:if="{{status}}"> isShow </view>

還可以添加else塊

<view wx:if="{{num > 5}}"> A </view>
<view wx:elif="{{num > 2}}"> B </view>
<view wx:else> C </view>

2.3 列表渲染

• 在組件上使用 wx:for屬性綁定一個數(shù)組，就可以渲染組件了
• 默認情況下數(shù)組的當前下標變量名為index,當前項的變量名為item

<view wx:for="{{array}}">
  {{index}}: {{item.message}}
</view>

Page({
  data: {
    array: ["AA","BB","CC"]
  }
})

使用 wx:for-item 可以指定數(shù)組當前元素的變量名很魂，使用 wx:for-index 可以指定數(shù)組當前下標的變量名

<view wx:for="{{array}}" wx:for-index="num" wx:for-item="itemName">
  {{num}}: {{itemName}}
</view>

2.4 模板template

• name 定義組件模版的名稱扎酷，引用模版的時候使用 is 屬性指定模版的名字，is 可以進行簡單的三目運算遏匆，需要傳入模版需要的 data 數(shù)據(jù)霞玄。
• 因為模版擁有自己的作用域，所以只能使用 data 傳入數(shù)據(jù)拉岁，而不接受雙花括號的寫法

<template name="msgItem">
<view>
<text> {{index}}: {{msg}} </text>
<text> Time: {{time}} </text>
</view>
</template>

<!-- 其他代碼 -->
<template is="msgItem" data="{{...item}}"/>

2.5 公共模塊的引用

• WXML 提供 import 和 include 兩種文件引用方式坷剧。
• import 有作用域的概念，不能多重引用

<!-- B.wxml -->
<import src="a.wxml"/>

<!-- A.wxml -->
<template name="A">
 <text> A template </text>
</template>

include 就可以多重引用

<!--引用 header喊暖、其中 header.wxml 中也引用了 footer.wxml-->
<include src="header.wxml"/>
<view> body </view>

<!-- header.wxml -->
<view> header </view>
<include src="footer.wxml"/>

2.6 事件

• 名稱以 bind 開頭的事件不阻止冒泡惫企，名稱以 catch 開頭的事件冒泡是阻止的。如 bindTap 和 catchTab
• 在 WXML 中，可以使用 dataset 定義data中的數(shù)據(jù)狞尔，會通過事件傳遞丛版。它的事件以 data-開頭，多個單詞以 - 鏈接偏序，如 data-a-b

三页畦、生命周期

3.1 App()應用生命周期

image

• 用戶首次打開小程序，觸發(fā) onLaunch（全局只觸發(fā)一次）研儒。
• 小程序初始化完成后豫缨，觸發(fā)onShow方法，監(jiān)聽小程序顯示端朵。
• 小程序從前臺進入后臺好芭，觸發(fā) onHide方法。
• 小程序從后臺進入前臺顯示冲呢，觸發(fā) onShow方法舍败。
• 小程序后臺運行一定時間，或系統(tǒng)資源占用過高敬拓，會被銷毀邻薯。
• 小程序出錯，觸發(fā)onError

前臺乘凸、后臺定義： 當用戶點擊左上角關閉弛说，或者按了設備 Home 鍵離開微信，小程序并沒有直接銷毀翰意，而是進入了后臺木人；當再次進入微信或再次打開小程序，又會從后臺進入前臺

//app.js
App({
  onLaunch: function() { 
      //小程序初始化(全局只觸發(fā)一次)
  },
  onShow: function() {
      //小程序顯示
  },
  onHide: function() {
      //小程序隱藏
  },
  onError: function(msg) {
      //小程序錯誤
  },
})
//其他 開發(fā)者可以添加任意的函數(shù)或數(shù)據(jù)到 Object 參數(shù)中冀偶，用 this 可以訪問

3.2 Page頁面生命周期

每個頁面也有自己的生命周期

image

• 小程序注冊完成后醒第，加載頁面，觸發(fā)onLoad方法进鸠。
• 頁面載入后觸發(fā)onShow方法稠曼，顯示頁面。
• 首次顯示頁面客年，會觸發(fā)onReady方法霞幅，渲染頁面元素和樣式，一個頁面只會調用一次量瓜。
• 當小程序后臺運行或跳轉到其他頁面時司恳，觸發(fā)onHide方法。
• 當小程序有后臺進入到前臺運行或重新進入頁面時绍傲，觸發(fā)onShow方法扔傅。
• 當使用重定向方法wx.redirectTo(OBJECT)或關閉當前頁返回上一頁wx.navigateBack()耍共，觸發(fā)onUnload

//index.js
Page({
  onLoad: function(options) {
    //頁面加載-----(一個頁面只會調用一次)
  },
  onReady: function() {
    //頁面渲染-----(一個頁面只會調用一次)
  },
  onShow: function() {
    //頁面顯示-----(每次打開頁面都會調用一次)
  },
  onHide: function() {
    //頁面隱藏-----(當navigateTo或底部tab切換時調用)
  },
  onUnload: function() {
    //頁面卸載-----(當redirectTo或navigateBack的時候調用)
  },
})
//其他 開發(fā)者可以添加任意的函數(shù)或數(shù)據(jù)到 object 參數(shù)中，在頁面的函數(shù)中用 this 可以訪問

3.3 應用生命周期影響頁面生命周期

image.png

• 小程序初始化完成后猎塞，頁面首次加載觸發(fā)onLoad试读，只會觸發(fā)一次。
• 當小程序進入到后臺荠耽，先執(zhí)行頁面onHide方法再執(zhí)行應用onHide方法钩骇。
• 當小程序從后臺進入到前臺，先執(zhí)行應用onShow方法再執(zhí)行頁面onShow方法

四铝量、小程序限制

4.1 程序限制

• 腳本內不能使用window等對象
• zepto/jquery 會使用到window對象和document對象倘屹，所以無法使用。
• 樣式表不支持級聯(lián)選擇器
• 本地資源無法通過 css 獲取 background-image可以使用網(wǎng)絡圖片款违，或者 base64唐瀑，或者使用標簽
• 不支持 A 標簽群凶，無法打開普通網(wǎng)頁

4.2 數(shù)量限制

• 底部或頂部可以添加tab按鈕區(qū)域 tabBar 是一個數(shù)組插爹，只能配置最少2個、最多5個 tab请梢，tab按數(shù)組的順序排序赠尾。
• 一個應用同時只能打開5個頁面
• 小程序的wx.request請求最開始最大并發(fā)數(shù)是5個，后來毅弧，估計隨著用小程序的越來越多气嫁，總之，就是增加到了10個

4.3 大小限制

• tabBar 上面的按鈕 iconPath 圖片路徑够坐，icon大小限制為40kb
• tabBar 上面的按鈕 selectedIconPath選中時的圖片路徑寸宵，icon 大小限制為40kb
• setData 頁面?zhèn)鬟f數(shù)據(jù)單次設置的數(shù)據(jù)不能超過1024kB
• setStorage 本地緩存最大為10MB
• 小程序源碼打包后的大小限制為2M

五、路由

• 微信路由接口有三個元咙，分別是wx.redirectTo梯影、wx.navigateTo和wx.switchTab
wx.navigateTo全局最多調用5次
• 如果某頁面設置為tab頁，則只支持wx.switchTab庶香，不支持其他兩種路由方式訪問

5.1 哪些情況會觸發(fā)頁面跳轉

• 小程序啟動甲棍，初始化第一個頁面
• 打開新頁面，調用 API wx.navigateTo 或使用<navigator />組件
• 頁面重定向赶掖，調用 API wx.redirectTo 或使用<navigator />組件
• 頁面返回感猛，調用 API wx.navigateBack或用戶按左上角返回按鈕
• tarbar切換

5.2 如何跳轉頁面

• 使用wx.navigateTo接口跳轉,原頁面保留

wx.navigateTo({
  //目的頁面地址
  url: 'pages/logs/index',
  success: function(res){},
  ...
})

• 使用wx.redirectTo接口跳轉，關閉原頁面,不能返回

wx.redirectTo({
  //目的頁面地址
  url: 'pages/logs/index',
  success: function(res){},
  ...
})

5.3 使用組件

<navigator url="pages/logs/index" hover-class="navigator-hover">跳轉</navigator>

當該組件添加redirect屬性時奢赂，等同于wx.redirectTo接口陪白；默認redirect屬性為false，等同于wx.navigateTo接口

用戶點擊左上角返回按鈕膳灶，或調用wx.navigateBack接口返回上一頁

wx.navigateBack({
    delta: 1
})

delta為1時表示返回上一頁拷泽，為2時表示上上一頁，以此類推；如果dalta大于已打開的頁面總數(shù)司致，則返回到首頁拆吆。返回后，元界面會銷毀

5.4 頁面跳轉傳值

url?key=value&key1=value1

傳遞的參數(shù)沒有被URIEncode,傳遞中文沒有亂碼

5.5 如何正確使用頁面跳轉

官方規(guī)定小程序最多只能有五個頁面同時存在脂矫，意思是在不關閉頁面的情況枣耀，最多新開五個頁面，頁面深度為5

• 對于可逆操作庭再，使用wx.navigateTo,比如從首頁跳轉到二級頁面捞奕，從二級頁面返回是不需要重新渲染首頁
• 對于不可逆操作，使用wx.redirectTo,比如用戶登錄成功后拄轻，關閉登錄頁面颅围，不能返回到登錄界面。
• 對于一些介紹性等不常用頁面wx.redirectTo或wx.navigatrBack
• 不要在首頁使用wx.redirectTo恨搓，這樣會導致應用無法返回首頁

5.6 頁面棧

• 頁面棧以棧（先進后出）的形式維護頁面與頁面之間的關系
• 小程序提供了getCurrentPages()函數(shù)獲取頁面棧院促，第一個元素為首頁，最后一個元素為當前頁面

使用wx.navigateTo每新開一個頁面斧抱，頁面棧大小加1,直到頁面棧大小為5為止

image.png

使用wx.navigateTo重復打開界面

image.png

假如使用wx.navigateTo從四級頁面跳轉到二級頁面常拓，此時會在頁面棧頂添加一個與二級頁面初始狀態(tài)一樣的界面，但兩個頁面狀態(tài)是獨立的辉浦。頁面棧大小會加1弄抬，如果頁面棧大小為5，則wx.navigateTo無效

使用wx.redirectTo重定向

image.png

假如使用wx.redirectTo從四級頁面重定向到二級頁面宪郊，此時會將關閉四級頁面掂恕，并使用二級頁面替換四級頁面，但兩個頁面狀態(tài)是獨立的弛槐。此時的頁面棧大小不變懊亡，請注意和使用wx.navigateTo的區(qū)別

使用wx.navigateBack返回

image.png

總結

• wx.navigateTo會增加頁面棧大小，直到頁面棧大小為5
• wx.redirectTo不會增加頁面棧大小
• wx.navigateBack會減少頁面棧大小丐黄，直到頁面棧大小為1

六斋配、數(shù)據(jù)通信

6.1 頁面之間的通信

• 使用全局變量 app.globalData
• 使用本地緩存 wx.setStorageSync
• url傳遞**

// A頁面-傳遞數(shù)據(jù)

// 需要注意的是，wx.switchTab 中的 url 不能傳參數(shù)灌闺。
wx.navigateTo({
   url:'../pageD/pageD?name=raymond&gender=male'
})

// B頁面-接收數(shù)據(jù)//

//通過onLoad的option...

Page({
onLoad: function(option){
 console.log(option.name +'is'+ option.gender)// raymond is male
  this.setData({option: option })
}})

6.2 參數(shù)傳遞

6.2.1 小程序傳遞參數(shù)的方式

1艰争、通過在App.js中設置全局變量

通常把不會更改的數(shù)據(jù)放在app.js的Data中，在各個頁面中都可以通過APP實例獲取Data數(shù)據(jù)

var app = getApp();
var data = app.data;

2桂对、通過拼接URL直接傳遞

wx.navigateTo({})中URL攜帶參數(shù)

wx.navigateTo({
  url: 'test?id=1'
});

在wxml中使用navigator跳轉url傳遞參數(shù)

代碼如下甩卓，將要傳遞到另一個頁面的字符串testId的值賦值到url中

<navigator class="test-item" url="../../pages/test/test?testId={{testData.testId}}"></navigator>

在js頁面中onLoad方法中接收

Page({
  onLoad: function(options) {
      var testId = options.testId
      console.log(testId)
  }
})

navigator跳轉url傳遞數(shù)組

如果一個頁面要將一個數(shù)組，如相冊列表傳遞到另一個頁面

<navigator class="test-item" url="../../pages/test/test?albumList={{testData.albumList}}"></navigator>

傳遞到js后從options中得到的是個字符串蕉斜，每個圖片的url通過','分隔逾柿，所以此時還需要對其進行處理缀棍，重新組裝為數(shù)組

Page({
    data: {
         // 相冊列表數(shù)據(jù)
        albumList: [],
    },    
    onLoad: function (options) {
        var that = this;

        that.setData({
            albumList: options.albumList.split(",")
        });
    }
})

3、在wxml中綁定事件后机错，通過data-hi="參數(shù)"的方式傳遞

這種方式一般是在wxml中綁定事件爬范，同時設置需要傳遞的數(shù)據(jù)，如果需要傳遞多個弱匪，可以寫多個data-[參數(shù)]的方式進行傳遞

<view bindtap="clickMe" data-testId={{testId}}">
    ...
</view>

在js頁面中自定義方法clickMe中接收

Page({
    clickMe: function(event) {
        var testId = event.currentTarget.dataset.testid;
        wx.navigateTo({
            url: '../../pages/test/test'
        })
    }
})

wxml中配置data-albumlist傳遞數(shù)組

<view bindtap="clickMe" data-albumlist={{testData.albumList}}">
    
</view>

在js頁面中自定義方法clickMe中接收

Page({
    clickMe: function(event) {
        var albumList = event.currentTarget.dataset.albumlist.split(",");
        wx.navigateTo({
            url: '../../pages/test/test'
        })
    }
})

4青瀑、通過數(shù)據(jù)緩存存儲再獲取

wx.setStorageSync(KEY,DATA)存儲數(shù)據(jù)

try {
  wx.setStorageSync('key', 'value')
} catch (e) {    
}

wx.getStorageSync(KEY)獲取數(shù)據(jù)

try {
  var value = wx.getStorageSync('key')
  if (value) {
    // Do something with return value
  }
} catch (e) {
   // Do something when catch error
}
或
wx.getStorage({
  key: 'key',
  success: function(res) {
     console.log(res.data)
  }
})

七、疑問匯總

為什么腳本內不能使用window等對象

• 頁面的腳本邏輯是在JsCore中運行萧诫，JsCore是一個沒有窗口對象的環(huán)境斥难，所以不能在腳本中使用window，也無法在腳本中操作組件

為什么 zepto/jquery 無法使用

• zepto/jquery 會使用到window對象和document對象帘饶，所以無法使用

wx.navigateTo無法打開頁面

• 一個應用同時只能打開5個頁面哑诊，當已經打開了5個頁面之后，wx.navigateTo不能正常打開新頁面及刻。請避免多層級的交互方式镀裤，或者使用wx.redirectTo

樣式表不支持級聯(lián)選擇器

• WXSS支持以.開始的類選擇器

本地資源無法通過 css 獲取

• background-image：可以使用網(wǎng)絡圖片，或者 base64提茁，或者使用<image/>標簽

如何修改窗口的背景色

• 使用 page 標簽選擇器淹禾，可以修改頂層節(jié)點的樣式

page { 
  display: block; 
  min-height: 100%; 
  background-color: red;
}

為什么上傳不成功

• 為了提升體驗流暢度馁菜，編譯后的代碼包大小需小于 2MB 茴扁，大于 2MB 的代碼包將上傳失敗

HTTPS 請求不成功

• tls 僅支持 1.2 及以上版本

微信小程序支持fetch或者promise嗎?

• promise工具目前不支持，fetch 客戶端不支持 工具下個版本保持統(tǒng)一

wx.request的POST方法的參數(shù)傳輸服務器接收不到的bug

• wx.request post 的 content-type 默認為 ‘application/json '
• 如果服務器沒有用到 json 解釋的話汪疮，可以把 content-type 設置回 urlencoded

wx.request({
....
method: "POST",
header: {
"content-type": "application/x-www-form-urlencoded"
},
...
})

wx.uploadFile在手機上返回http碼403

• 安卓的微信升級到6.5.2及其以上版本

小程序SVG支持嗎?

• image的src放遠程svg可以峭火，background-image里也可以

ipad不能使用小程序？

• 暫時不支持ipad打開小程序

請問小程序頁內支持長按保存圖片或分享圖片嗎智嚷？

• 目前沒有這個功能

微信小程序不支持cookie

• 使用Reids存儲session

有些手機不支持Object.assign方法卖丸，如果使用了該方法會出現(xiàn)莫名其妙的報錯（并不會提示Object.assign is not function，而是導致調用了Object.assign方法的方法不能被調用）盏道！

直接寫一個合并對象的方法

function assignObject(o, n) {
    for (var p in n) {
        if (n.hasOwnProperty(p) && (!o.hasOwnProperty(p)))
            o[p] = n[p];
    }
}

八稍浆、小程序組件

image.png

九、參考

• 小程序官網(wǎng)