1. 程式人生 > >小程式提示框

小程式提示框

wx.showToast(OBJECT)

顯示訊息提示框

OBJECT引數說明:

引數型別必填說明最低版本
titleString提示的內容
iconString圖示,有效值 "success", "loading", "none"
imageString自定義圖示的本地路徑,image 的優先順序高於 icon1.1.0
durationNumber提示的延遲時間,單位毫秒,預設:1500
maskBoolean是否顯示透明蒙層,防止觸控穿透,預設:false
successFunction介面呼叫成功的回撥函式
failFunction介面呼叫失敗的回撥函式
completeFunction介面呼叫結束的回撥函式(呼叫成功、失敗都會執行)

icon有效值

有效值說明最低版本
success顯示成功圖示,此時 title 文字最多顯示 7 個漢字長度。預設值
loading顯示載入圖示,此時 title 文字最多顯示 7 個漢字長度。
none不顯示圖示,此時 title 文字最多可顯示兩行1.9.0

示例程式碼:

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

wx.showLoading(OBJECT)

基礎庫 1.1.0 開始支援,低版本需做相容處理

顯示 loading 提示框, 需主動呼叫 wx.hideLoading 才能關閉提示框

OBJECT引數說明:

引數型別必填說明
titleString提示的內容
maskBoolean是否顯示透明蒙層,防止觸控穿透,預設:false
successFunction介面呼叫成功的回撥函式
failFunction介面呼叫失敗的回撥函式
completeFunction介面呼叫結束的回撥函式(呼叫成功、失敗都會執行)

wx.hideToast()

隱藏訊息提示框

wx.hideLoading()

基礎庫 1.1.0 開始支援,低版本需做相容處理

隱藏 loading 提示框

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

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

wx.showModal(OBJECT)

​顯示模態彈窗

OBJECT引數說明:

引數型別必填說明
titleString提示的標題
contentString提示的內容
showCancelBoolean是否顯示取消按鈕,預設為 true
cancelTextString取消按鈕的文字,預設為"取消",最多 4 個字元
cancelColorHexColor取消按鈕的文字顏色,預設為"#000000"
confirmTextString確定按鈕的文字,預設為"確定",最多 4 個字元
confirmColorHexColor確定按鈕的文字顏色,預設為"#3CC51F"
successFunction介面呼叫成功的回撥函式
failFunction介面呼叫失敗的回撥函式
completeFunction介面呼叫結束的回撥函式(呼叫成功、失敗都會執行)

success返回引數說明:

引數型別說明最低版本
confirmBoolean為 true 時,表示使用者點選了確定按鈕
cancelBoolean為 true 時,表示使用者點選了取消(用於 Android 系統區分點選蒙層關閉還是點選取消按鈕關閉)1.1.0

示例程式碼:

wx.showModal({
  title: '提示',
  content: '這是一個模態彈窗',
  success: function(res) {
    if (res.confirm) {
      console.log('使用者點選確定')
    } else if (res.cancel) {
      console.log('使用者點選取消')
    }
  }
})

wx.showActionSheet(OBJECT)

​顯示操作選單

OBJECT引數說明:

引數型別必填說明
itemListString Array按鈕的文字陣列,陣列長度最大為6個
itemColorHexColor按鈕的文字顏色,預設為"#000000"
successFunction介面呼叫成功的回撥函式,詳見返回引數說明
failFunction介面呼叫失敗的回撥函式
completeFunction介面呼叫結束的回撥函式(呼叫成功、失敗都會執行)

success返回引數說明:

引數型別說明
tapIndexNumber使用者點選的按鈕,從上到下的順序,從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: Android 6.3.30,wx.showModal 的返回的 confirm 一直為 true;
  2. tip: wx.showActionSheet 點選取消或蒙層時,回撥 fail, errMsg 為 "showActionSheet:fail cancel";
  3. tip: wx.showLoading 和 wx.showToast 同時只能顯示一個,但 wx.hideToast/wx.hideLoading 也應當配對使用;
  4. tip: iOS wx.showModal 點選蒙層不會關閉模態彈窗,所以儘量避免使用“取消”分支中實現業務邏輯。