Appearance
微信原生 API 封装 - message
为了确保项目代码的一致性和规范性而设计的 API 封装,旨在简化微信小程序中的页面提示和加载。
以下是包含的方法列表,强烈建议在项目中使用它们,而非使用 uni.xxx
或 wx.xxx
:
- message.showToast(支持异步等待关闭)
- message.showLoading/message.hideLoading
- message.showModal
- message.showPrompt
- message.showIOErrorModal
基本用法
showToast
js
import {message} from '@ifanrx/uni-mp'
message.showToast('这是一个提示')
await message.showToast('这是一个可等待关闭的提示', {
duration: 3000,
})
showLoading/hideLoading
js
message.showLoading('加载中')
message.hideLoading()
showModal
js
message
.showModal('这是一条询问', {
title: '提示',
})
.then(res => {
message.showToast(`你点击了${res.confirm ? '确定' : '取消'}`)
})
showPrompt
js
message.showPrompt('请输入内容').then(res => {
if (res.confirm) {
message.showToast(`你输入了:${res.content}`)
return
}
message.showToast(`你点击了取消`)
})
showIOErrorModal
js
try {
throw new IOError({code: 10001, displayMessage: '请求失败'})
throw new IOError({
code: -1,
message: '601: request timeout',
displayMessage: '',
})
} catch (error) {
message.showIOErrorModal(error, {
10001: '优先显示自定义报错',
'request timeout': '网络超时',
default: '当最终文案为空时,使用该默认回退文案',
})
}