小程序顯示模態(tài)對(duì)話框
wx.showModal(Object object)
顯示模態(tài)對(duì)話框
參數(shù)
Object object
屬性 類型 默認(rèn)值 必填 說(shuō)明 最低版本
title string 否 提示的標(biāo)題
content string 否 提示的內(nèi)容
showCancel boolean true 否 是否顯示取消按鈕
cancelText string 取消 否 取消按鈕的文字,最多 4 個(gè)字符
cancelColor string #000000 否 取消按鈕的文字顏色,必須是 16 進(jìn)制格式的顏色字符串
confirmText string 確定 否 確認(rèn)按鈕的文字,最多 4 個(gè)字符
confirmColor string #576B95 否 確認(rèn)按鈕的文字顏色,必須是 16 進(jìn)制格式的顏色字符串
editable boolean false 否 是否顯示輸入框 2.17.1
placeholderText string 否 顯示輸入框時(shí)的提示文本 2.17.1
success function 否 接口調(diào)用成功的回調(diào)函數(shù)
fail function 否 接口調(diào)用失敗的回調(diào)函數(shù)
complete function 否 接口調(diào)用結(jié)束的回調(diào)函數(shù)(調(diào)用成功、失敗都會(huì)執(zhí)行)
object.success 回調(diào)函數(shù)
參數(shù)
Object res
屬性 類型 說(shuō)明 最低版本
content string editable 為 true 時(shí),用戶輸入的文本
confirm boolean 為 true 時(shí),表示用戶點(diǎn)擊了確定按鈕
cancel boolean 為 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 (res) {
if (res.confirm) {
console.log('用戶點(diǎn)擊確定')
} else if (res.cancel) {
console.log('用戶點(diǎn)擊取消')
}
}
})
注意
Android 6.7.2 以下版本,點(diǎn)擊取消或蒙層時(shí),回調(diào) fail, errMsg 為 "fail cancel";
Android 6.7.2 及以上版本 和 iOS 點(diǎn)擊蒙層不會(huì)關(guān)閉模態(tài)彈窗,所以盡量避免使用「取消」分支中實(shí)現(xiàn)業(yè)務(wù)邏輯
自基礎(chǔ)庫(kù) 2.17.1 版本起,支持傳入 editable 參數(shù),顯示帶輸入框的彈窗
作者:大學(xué)生新聞網(wǎng) 來(lái)源:大學(xué)生新聞網(wǎng)
發(fā)布時(shí)間:2025-04-03 閱讀: