微信小程序API 交互反饋

2018-08-21 15:20 更新

wx.showToast(OBJECT)

顯示消息提示框。

OBJECT參數(shù)說明:

參數(shù)類型必填說明最低版本
titleString提示的內(nèi)容 
iconString圖標(biāo),有效值"success"、"loading" 
imageString自定義圖標(biāo)的本地路徑,image 的優(yōu)先級(jí)高于 icon1.1.0
durationNumber提示的延遲時(shí)間,單位毫秒,默認(rèn):1500 
maskBoolean是否顯示透明蒙層,防止觸摸穿透,默認(rèn):false 
successFunction接口調(diào)用成功的回調(diào)函數(shù) 
failFunction接口調(diào)用失敗的回調(diào)函數(shù) 
completeFunction接口調(diào)用結(jié)束的回調(diào)函數(shù)(調(diào)用成功、失敗都會(huì)執(zhí)行) 

示例代碼:

wx.showToast({
  title: '成功',
  icon: 'success',
  duration: 2000
})

wx.showLoading(OBJECT)

基礎(chǔ)庫版本 1.1.0 開始支持,低版本需做兼容處理

顯示 loading 提示框, 需主動(dòng)調(diào)用 wx.hideLoading 才能關(guān)閉提示框

OBJECT參數(shù)說明:

參數(shù)類型必填說明
titleString提示的內(nèi)容
maskBoolean是否顯示透明蒙層,防止觸摸穿透,默認(rèn):false
successFunction接口調(diào)用成功的回調(diào)函數(shù)
failFunction接口調(diào)用失敗的回調(diào)函數(shù)
completeFunction接口調(diào)用結(jié)束的回調(diào)函數(shù)(調(diào)用成功、失敗都會(huì)執(zhí)行)

wx.hideToast()

隱藏消息提示框

wx.hideLoading()


基礎(chǔ)庫版本 1.1.0 開始支持,低版本需做兼容處理

隱藏loading提示框

wx.showLoading({
  title: '加載中',
})

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

wx.showModal(OBJECT)

?顯示模態(tài)彈窗

OBJECT參數(shù)說明:

參數(shù)類型必填說明
titleString提示的標(biāo)題
contentString提示的內(nèi)容
showCancelBoolean是否顯示取消按鈕,默認(rèn)為 true
cancelTextString取消按鈕的文字,默認(rèn)為"取消",最多 4 個(gè)字符
cancelColorHexColor取消按鈕的文字顏色,默認(rèn)為"#000000"
confirmTextString確定按鈕的文字,默認(rèn)為"確定",最多 4 個(gè)字符
confirmColorHexColor確定按鈕的文字顏色,默認(rèn)為"#3CC51F"
successFunction接口調(diào)用成功的回調(diào)函數(shù)
failFunction接口調(diào)用失敗的回調(diào)函數(shù)
completeFunction接口調(diào)用結(jié)束的回調(diào)函數(shù)(調(diào)用成功、失敗都會(huì)執(zhí)行)

succes返回參數(shù)說明:

參數(shù)類型說明最低版本
confirmBoolean為 true 時(shí),表示用戶點(diǎn)擊了確定按鈕 
cancelBoolean為 true 時(shí),表示用戶點(diǎn)擊了取消(用于 Android 系統(tǒng)區(qū)分點(diǎn)擊蒙層關(guān)閉還是點(diǎn)擊取消按鈕關(guān)閉)1.1.0

示例代碼:

wx.showModal({
  title: '提示',
  content: '這是一個(gè)模態(tài)彈窗',
  success: function(res) {
    if (res.confirm) {
      console.log('用戶點(diǎn)擊確定')
    } else if (res.cancel) {
      console.log('用戶點(diǎn)擊取消')
    }
  }
})

wx.showActionSheet(OBJECT)

?顯示操作菜單

OBJECT參數(shù)說明:

參數(shù)類型必填說明
itemListString Array按鈕的文字?jǐn)?shù)組,數(shù)組長度最大為6個(gè)
itemColorHexColor按鈕的文字顏色,默認(rèn)為"#000000"
successFunction接口調(diào)用成功的回調(diào)函數(shù),詳見返回參數(shù)說明
failFunction接口調(diào)用失敗的回調(diào)函數(shù)
completeFunction接口調(diào)用結(jié)束的回調(diào)函數(shù)(調(diào)用成功、失敗都會(huì)執(zhí)行)

success返回參數(shù)說明:

參數(shù)類型說明
tapIndexNumber用戶點(diǎn)擊的按鈕,從上到下的順序,從0開始

示例代碼:

wx.showActionSheet({
  itemList: ['A', 'B', 'C'],
  success: function(res) {
    console.log(res.tapIndex)
  },
  fail: function(res) {
    console.log(res.errMsg)
  }
})

Bug & Tip

  1. bug:Android6.3.30,wx.showModal 的返回的 confirm 一直為 true;
  2. tip: wx.showActionSheet 點(diǎn)擊取消或蒙層時(shí),回調(diào)fail, errMsg 為 "showActionSheet:fail cancel";
  3. tip: wx.showLoading 和 wx.showToast 同時(shí)只能顯示一個(gè),使用 wx.hideToast/wx.hideLoading 都可以關(guān)閉提示框;
  4. tip: iOS wx.showModal 點(diǎn)擊蒙層不會(huì)關(guān)閉模態(tài)彈窗,所以盡量避免使用“取消”分支中實(shí)現(xiàn)業(yè)務(wù)邏輯。
以上內(nèi)容是否對(duì)您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號(hào)
微信公眾號(hào)

編程獅公眾號(hào)