小程式提示框
阿新 • • 發佈:2019-01-03
wx.showToast(OBJECT)
顯示訊息提示框
OBJECT引數說明:
引數 | 型別 | 必填 | 說明 | 最低版本 |
---|---|---|---|---|
title | String | 是 | 提示的內容 | |
icon | String | 否 | 圖示,有效值 "success", "loading", "none" | |
image | String | 否 | 自定義圖示的本地路徑,image 的優先順序高於 icon | 1.1.0 |
duration | Number | 否 | 提示的延遲時間,單位毫秒,預設:1500 | |
mask | Boolean | 否 | 是否顯示透明蒙層,防止觸控穿透,預設:false | |
success | Function | 否 | 介面呼叫成功的回撥函式 | |
fail | Function | 否 | 介面呼叫失敗的回撥函式 | |
complete | Function | 否 | 介面呼叫結束的回撥函式(呼叫成功、失敗都會執行) |
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引數說明:
引數 | 型別 | 必填 | 說明 |
---|---|---|---|
title | String | 是 | 提示的內容 |
mask | Boolean | 否 | 是否顯示透明蒙層,防止觸控穿透,預設:false |
success | Function | 否 | 介面呼叫成功的回撥函式 |
fail | Function | 否 | 介面呼叫失敗的回撥函式 |
complete | Function | 否 | 介面呼叫結束的回撥函式(呼叫成功、失敗都會執行) |
wx.hideToast()
隱藏訊息提示框
wx.hideLoading()
基礎庫 1.1.0 開始支援,低版本需做相容處理
隱藏 loading 提示框
wx.showLoading({
title: '載入中',
})
setTimeout(function(){
wx.hideLoading()
},2000 )
wx.showModal(OBJECT)
顯示模態彈窗
OBJECT引數說明:
引數 | 型別 | 必填 | 說明 |
---|---|---|---|
title | String | 是 | 提示的標題 |
content | String | 是 | 提示的內容 |
showCancel | Boolean | 否 | 是否顯示取消按鈕,預設為 true |
cancelText | String | 否 | 取消按鈕的文字,預設為"取消",最多 4 個字元 |
cancelColor | HexColor | 否 | 取消按鈕的文字顏色,預設為"#000000" |
confirmText | String | 否 | 確定按鈕的文字,預設為"確定",最多 4 個字元 |
confirmColor | HexColor | 否 | 確定按鈕的文字顏色,預設為"#3CC51F" |
success | Function | 否 | 介面呼叫成功的回撥函式 |
fail | Function | 否 | 介面呼叫失敗的回撥函式 |
complete | Function | 否 | 介面呼叫結束的回撥函式(呼叫成功、失敗都會執行) |
success返回引數說明:
引數 | 型別 | 說明 | 最低版本 |
---|---|---|---|
confirm | Boolean | 為 true 時,表示使用者點選了確定按鈕 | |
cancel | Boolean | 為 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引數說明:
引數 | 型別 | 必填 | 說明 |
---|---|---|---|
itemList | String Array | 是 | 按鈕的文字陣列,陣列長度最大為6個 |
itemColor | HexColor | 否 | 按鈕的文字顏色,預設為"#000000" |
success | Function | 否 | 介面呼叫成功的回撥函式,詳見返回引數說明 |
fail | Function | 否 | 介面呼叫失敗的回撥函式 |
complete | Function | 否 | 介面呼叫結束的回撥函式(呼叫成功、失敗都會執行) |
success返回引數說明:
引數 | 型別 | 說明 |
---|---|---|
tapIndex | Number | 使用者點選的按鈕,從上到下的順序,從0開始 |
示例程式碼:
wx.showActionSheet({
itemList: ['A', 'B', 'C'],
success: function(res) {
console.log(res.tapIndex)
},
fail: function(res) {
console.log(res.errMsg)
}
})
Bug & Tip
bug
:Android
6.3.30
,wx.showModal 的返回的 confirm 一直為 true;tip
: wx.showActionSheet 點選取消或蒙層時,回撥fail
, errMsg 為 "showActionSheet:fail cancel";tip
: wx.showLoading 和 wx.showToast 同時只能顯示一個,但 wx.hideToast/wx.hideLoading 也應當配對使用;tip
:iOS
wx.showModal 點選蒙層不會關閉模態彈窗,所以儘量避免使用“取消”分支中實現業務邏輯。