互動
hideloading
TIP
該API使用方法為： wx.hideLoading(Object object)
- 功能說明： 隱藏loading提示框。
- 參數及說明： Object object
| 内容 | 類型 | 預設值 | 必填 | 說明 |
|---|---|---|---|---|
| noConflict | boolean | false | 否 | 現時toast和loading相關接口可以相互混用，此參數可用於取消混用特性 |
| success | Function | - | 否 | 接口調用成功的回呼函數 |
| fail | Function | - | 否 | 接口調用失敗的回呼函數 |
| complete | Function | - | 否 | 接口調用結束的回呼函數（無論成功與否都執行） |
hideToast
TIP
該API使用方法為： wx.hideToast(Object object)
- 功能說明： 隱藏消息提示框。
- 參數及說明： Object object
| 内容 | 類型 | 預設值 | 必填 | 說明 |
|---|---|---|---|---|
| noConflict | boolean | false | 否 | 現時toast和loading相關接口可以相互混用，此參數可用於取消混用特性 |
| success | Function | - | 否 | 接口調用成功的回呼函數 |
| fail | Function | - | 否 | 接口調用失敗的回呼函數 |
| complete | Function | - | 否 | 接口調用結束的回呼函數（無論成功與否都執行） |
showActionSheet
TIP
該API使用方法為： wx.showActionSheet(Object object)
TIP
- Android 6.7.2以下版本，點擊取消或蒙層時，回檔fail， errMsg為'fail cancel'。
- Android 6.7.2及以上版本和iOS點擊蒙層不會關閉模態彈窗，所以儘量避免使用「取消」分支中實現業務邏輯。
- 功能說明： 顯示操作選單
- 參數及說明： Object object
| 内容 | 類型 | 預設值 | 必填 | 說明 |
|---|---|---|---|---|
| itemList | array.<string> | - | 是 | 按鈕的文字數組，數組長度最大為6 |
| itemColor | string | #000000 | 否 | 按鈕的文字顏色 |
| success | Function | - | 否 | 接口調用成功的回呼函數 |
| fail | Function | - | 否 | 接口調用失敗的回呼函數 |
| complete | Function | - | 否 | 接口調用結束的回呼函數（無論成功與否都執行） |
- object.success回呼函數參數： Object res
| 内容 | 類型 | 說明 |
|---|---|---|
| tapIndex | number | 用戶按一下的按鈕序號，從上到下的順序，從0開始 |
- 示例代碼：
js
wx.showActionSheet({
itemList: ['A', 'B', 'C'],
success (res) {
console.log(res.tapIndex)
},
fail (res) {
console.log(res.errMsg)
}
})showLoading
TIP
該API使用方法為： wx.showLoading(Object object)
- 功能說明： 顯示loading提示框, wx.hideLoading 才能關閉提示框。
- 參數及說明： Object object
| 内容 | 類型 | 預設值 | 必填 | 說明 |
|---|---|---|---|---|
| title | string | - | 是 | 提示的內容 |
| mask | boolean | false | 否 | 是否顯示透明蒙層，防止觸摸穿透 |
| success | Function | - | 否 | 接口調用成功的回呼函數 |
| fail | Function | - | 否 | 接口調用失敗的回呼函數 |
| complete | Function | - | 否 | 接口調用結束的回呼函數（無論成功與否都執行） |
- 示例代碼：
js
wx.showLoading({
title: 'loading',
})
setTimeout(function () {
wx.hideLoading()
}, 2000)TIP
- wx.showLoading 和 wx.showToast同時只能顯示一個。
- wx.showLoading 應與 wx.hideLoading配對使用。
showModal
TIP
該API使用方法為： wx.showModal(Object object)
TIP
- Android 6.7.2以下版本，點擊取消或蒙層時，回檔fail， errMsg為'fail cancel'。
- Android 6.7.2及以上版本和iOS點擊蒙層不會關閉模態彈窗，所以儘量避免使用「取消」分支中實現業務邏輯。
- 功能說明： 顯示模態對話方塊
- 參數及說明： Object object
| 内容 | 類型 | 預設值 | 必填 | 說明 |
|---|---|---|---|---|
| title | string | - | 否 | 提示的標題 |
| content | string | - | 否 | 提示的內容 |
| showCancel | boolean | true | 否 | 是否顯示取消按鈕 |
| cancelText | string | cancel | 否 | 取消按鈕的文字，最多4個字元 |
| cancelColor | string | #000000 | 否 | 取消按鈕的文字顏色，必須是16進制格式的顏色字串 |
| confirmText | string | confirm | 否 | 確認按鈕的文字，最多4個字符 |
| confirmColor | string | #576B95 | 否 | 確認按鈕的文字顏色，必須是16進位格式的顏色字串 |
| success | Function | - | 否 | 接口調用成功的回呼函數 |
| fail | Function | - | 否 | 接口調用失敗的回呼函數 |
| complete | Function | - | 否 | 接口調用結束的回呼函數（無論成功與否都執行） |
- object.success回呼函數參數： Object res
| 内容 | 類型 | 說明 |
|---|---|---|
| confirm | boolean | 為true時，表示用戶按一下了確定按鈕 |
| cancel | boolean | 為true時，表示用戶按一下了取消（用於Android系統區分按一下蒙層關閉還是按一下取消按鈕關閉） |
- 示例代碼：
js
wx.showModal({
title: 'Prompt',
content: 'This is a modal dialog box',
success (res) {
if (res.confirm) {
console.log(User clicked "Confirm")
} else if (res.cancel) {
console.log(User clicked "Cancel")
}
}
})showToast
TIP
該API使用方法為： wx.showModal(Object object)
- 功能說明： 顯示消息提示框
- 參數及說明： Object object
| 内容 | 類型 | 預設值 | 必填 | 說明 |
|---|---|---|---|---|
| title | string | - | 是 | 提示的內容 |
| icon | string | success | 否 | 圖標，其合法值為： 1.success: 顯示成功圖標，此時title文字最多顯示7個漢字長度 2.error: 顯示失敗圖標，此時title文字最多顯示7個漢字長度 3.loading: 顯示加載圖標，此時title文字最多顯示7個漢字長度 4.none: 不顯示圖標，此時title文字最多可顯示兩行 |
| image | string | - | 否 | 自定義圖標的本地路徑，image的優先順序高於icon |
| duration | number | 1500 | 否 | 提示的延遲時間 |
| mask | boolean | false | 否 | 是否顯示透明蒙層，防止觸摸穿透 |
| success | Function | - | 否 | 接口調用成功的回呼函數 |
| fail | Function | - | 否 | 接口調用失敗的回呼函數 |
| complete | Function | - | 否 | 接口調用結束的回呼函數（無論成功與否都執行） |
- 示例代碼：
js
wx.showToast({
title: 'success',
icon: 'success',
duration: 2000
})TIP
- wx.showLoading 和 wx.showToast同時只能顯示一個。
- wx.showLoading 應與 wx.hideLoading配對使用。
enableAlertBeforeUnload
TIP
該API使用方法為： wx.enableAlertBeforeUnload(Object object)
功能說明： 開啟小程序頁面返回詢問對話方塊
彈跳窗條件：
- 當用戶在小程序內非首頁頁面/最底層頁。
- 官方導航欄上的返回。
- 全屏模式下自繪返回鍵。
- android系統back鍵時。
TIP
- 手勢滑動返回時不做攔截。
- 在任何場景下，此功能都不應攔住用戶退出小程序的行為。
參數及說明： Object object
| 内容 | 類型 | 預設值 | 必填 | 說明 |
|---|---|---|---|---|
| message | string | - | 是 | 詢問對話方塊內容 |
| success | Function | - | 否 | 接口調用成功的回呼函數 |
| fail | Function | - | 否 | 接口調用失敗的回呼函數 |
| complete | Function | - | 否 | 接口調用結束的回呼函數（無論成功與否都執行） |
disableAlertBeforeUnload
TIP
該API使用方法為： wx.disableAlertBeforeUnload(Object object)
- 功能說明： 關閉小程序頁面返回詢問對話方塊
- 參數及說明： Object object
| 内容 | 類型 | 預設值 | 必填 | 說明 |
|---|---|---|---|---|
| success | Function | - | 否 | 接口調用成功的回呼函數 |
| fail | Function | - | 否 | 接口調用失敗的回呼函數 |
| complete | Function | - | 否 | 接口調用結束的回呼函數（無論成功與否都執行） |