uniapp封装uni.showToast提示消息框

uni.showToast(options)函数是一个用来弹出toast消息提示框的函数。它接受一个options参数，用于配置toast的显示内容和样式。常用的参数选项包括： - title: 设置toast消息的内容。 - mask: 设置是否显示透明蒙层，防止触摸穿透。 - icon: 设置toast消息的图标，常用的值有'success'、'loading'、'none'。 - duration: 设置toast消息的持续时间，单位为毫秒，默认值为1500。 示例代码中的toast函数是一个封装了uni.showToast的方法，它支持页面跳转。loading函数用来显示加载动画，hideLoading函数用来隐藏加载动画并支持页面跳转。 引用和引用提供了uni.showToast函数的使用示例和封装方法。

在 Uni-app 中，`uni.showToast()` 方法本身并不支持直接显示图片。该方法主要用于展示简单的文字提示，并不提供图片显示的功能[^1]。然而，可以通过其他方式来实现带有图片的提示效果。 如果需要实现带图片的提示功能，可以考虑以下两种替代方案： --- ### 方案一：使用 `uni.showModal()` 或自定义弹窗 虽然 `uni.showToast()` 不支持图片，但可以通过 `uni.showModal()` 结合 HTML 和 CSS 自定义一个模态框来实现带图片的提示效果。以下是具体代码示例： ```html <template> <view> <!-- 按钮触发 --> <button @click="showCustomToast">显示带图提示</button> <!-- 自定义弹窗 --> <view class="custom-toast" v-if="isShow"> <image src="/static/example.png" mode="aspectFit"></image> <!-- 替换为实际图片路径 --> <text>这是一个带图的提示</text> </view> </view> </template> <script> export default { data() { return { isShow: false, }; }, methods: { showCustomToast() { this.isShow = true; setTimeout(() => { this.isShow = false; // 延迟隐藏弹窗 }, 2000); // 设置持续时间为2秒 }, }, }; </script> <style> .custom-toast { position: fixed; top: 50%; left: 50%; transform: translate(-50%, -50%); background-color: rgba(0, 0, 0, 0.8); padding: 20px; border-radius: 10px; z-index: 999; } .custom-toast image { width: 100px; height: 100px; display: block; margin: 0 auto; } .custom-toast text { color: white; text-align: center; } </style> ``` 上述代码展示了如何通过 Vue 组件创建一个带图片的自定义提示框[^4]。 --- ### 方案二：引入第三方插件或组件库 如果希望更方便地实现带图片的提示功能，可以选择一些现成的 UI 库或插件。例如，基于 `uni-popup` 的扩展组件能够轻松实现复杂的提示需求。以下是一个简单示例： #### 安装依赖 首先安装 `uni-popup` 插件： ```bash npm install @dcloudio/uni-ui ``` #### 使用示例 ```javascript import uniPopup from '@dcloudio/uni-ui/lib/uni-popup/uni-popup.vue'; export default { components: { uniPopup }, methods: { openImageToast() { const popup = this.$refs.popup.open({ type: 'center', content: `<div style="text-align:center;"> <img src="/static/example.png" alt="example" style="width:100px;height:auto;" /> <p>这是一条带图的消息</p> </div>`, }); }, }, }; ``` 此方法利用了 `uni-popup` 的灵活性，允许嵌入任意 HTML 内容，从而实现带图片的提示效果[^3]。 --- ### 注意事项 - 如果仅需简单的文字提示，推荐继续使用 `uni.showToast()`，因为它性能更高且无需额外维护复杂逻辑。 - 对于需要频繁使用的场景，建议封装一个通用的方法或组件以便重复调用[^5]。 ---