微信小程序開發文檔

https://mp.weixin.qq.com/debug/wxadoc/dev/?t=20161107

使用步驟

• 下載微信小程序開發工具
• 微信小程序注冊申請 ，獲取AppID(手機預覽需用到)
• 服務器配置 ，添加合法域名，每個月只可修改3次 ，可添加多個域名
• 下載開發工具后創建項目，輸入申請的AppID，填寫項目名稱，導入該工程
• 項目預覽體驗

必須掌握的幾個知識點

目錄

• 小程序配置
• 小程序常用API接口

小程序配置

• app.json文件小程序設置全局配置 ，包括頁面路徑、窗口、選項卡，以及網絡超時等

{
  "pages": [
    "pages/index/index",
    "pages/logs/index"
  ],
  "window": {
    "navigationBarTitleText": "Demo"
  },
  "tabBar": {
    "list": [{
      "pagePath": "pages/index/index",
      "text": "首頁"
    }, {
      "pagePath": "pages/logs/logs",
      "text": "日志"
    }]
  },
  "networkTimeout": {
    "request": 10000,
    "downloadFile": 10000
  },
  "debug": true
}

• 通過appapp.js文件中App()來注冊一個小程序 提供了生命周期方法

App({
  onLaunch: function() { 
    // Do something initial when launch.
  },
  onShow: function() {
      // Do something when show.
  },
  onHide: function() {
      // Do something when hide.
  },
  globalData: 'I am global data'
})

通過全局的getApp()函數，獲取小程序實例

// other.js
var appInstance = getApp()
console.log(appInstance.globalData) // I am global data

注意：

App() 必須在 app.js 中注冊，且不能注冊多個。

不要在定義于 App() 內的函數中調用 getApp() ，使用 this 就可以拿到 app 實例。

不要在 onLaunch 的時候調用 getCurrentPage()，此時 page 還沒有生成。

通過 getApp() 獲取實例之后，不要私自調用生命周期函數。

• 通過Page() 函數用來注冊頁面

//index.js
Page({
  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.
  },
  // Event handler.
  viewTap: function() {
    this.setData({
      text: 'Set some data for updating view.'
    })
  },
  customData: {
    hi: 'MINA'
  }
})

小程序常用API接口

• wx.request https網絡請求

wx.request({
  url: 'test.php', //僅為示例，并非真實的接口地址
  method:"GET",
  data: {
     x: '' ,
     y: ''
  },
  header: {
      'content-type': 'application/json'
  },
  success: function(res) {
    console.log(res.data)
  }
})

• 本地緩存

通過key的形式添加緩存setStorage （異步接口）

wx.setStorage({
  key:"key"
  data:"value"
})

通過key的形式獲取緩存getStorage （異步接口）

wx.getStorage({
  key: 'key',
  success: function(res) {
      console.log(res.data)
  } 
})

從本地緩存中異步移除指定 key

wx.removeStorage({
  key: 'key',
  success: function(res) {
    console.log(res.data)
  } 
})

清理本地數據緩存

wx.clearStorage()

• 顯示、隱藏消息提示框

wx.showToast({
  title: '加載中',
  icon: 'loading',
  duration: 10000
})

setTimeout(function(){
  wx.hideToast()
},2000)

• 動態設置當前頁面的標題

wx.setNavigationBarTitle({
  title: '當前頁面'
})

• 導航

保留當前頁面，跳轉到應用內的某個頁面

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

關閉當前頁面，跳轉到應用內的某個頁面

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

• 獲取用戶信息，需要先調用 wx.login 接口

wx.getUserInfo({
  success: function(res) {
    var userInfo = res.userInfo
    var nickName = userInfo.nickName
    var avatarUrl = userInfo.avatarUrl
    var gender = userInfo.gender //性別 0：未知、1：男、2：女 
    var province = userInfo.province
    var city = userInfo.city
    var country = userInfo.country
  }
})

• 設備

獲取網絡類型

wx.getNetworkType({
  success: function(res) {
    var networkType = res.networkType // 返回網絡類型2g，3g，4g，wifi
  }
})

獲取系統信息（異步接口）

wx.getSystemInfo({
  success: function(res) {
    console.log(res.model)
    console.log(res.pixelRatio)
    console.log(res.windowWidth)
    console.log(res.windowHeight)
    console.log(res.language)
    console.log(res.version)
  }
})

撥打電話

wx.makePhoneCall({
  phoneNumber: '1340000' //僅為示例，并非真實的電話號碼
})

• 獲取當前的地理位置、速度

wx.getLocation({
  type: 'wgs84',
  success: function(res) {
    var latitude = res.latitude
    var longitude = res.longitude
    var speed = res.speed
    var accuracy = res.accuracy
  }
})