uni-app 之 uni.showToast

uni.showToast 是 uni-app 中用于显示消息提示框的 API,可以用来展示简单的操作反馈或状态提示。

基本用法

javascript 复制代码
uni.showToast({
  title: "提示内容",
  icon: "success",
  duration: 2000,
});

参数说明

参数 类型 默认值 必填 说明
title String - 提示的内容
icon String 'success' 图标类型,有效值包括:'success'、'loading'、'none'
image - 自定义图标的本地路径
duration Number 1500 提示的延迟时间,单位毫秒
mask Boolean false 是否显示透明蒙层,防止触摸穿透
success Function - 接口调用成功的回调函数
fail Function - 接口调用失败的回调函数
complete Function - 接口调用结束的回调函数(调用成功、失败都会执行)

icon 类型说明

  • 'success': 显示成功图标
  • 'loading': 显示加载图标
  • 'none': 不显示图标

示例代码

成功提示
javascript 复制代码
uni.showToast({
  title: "操作成功",
  icon: "success",
  duration: 2000,
});
加载提示
javascript 复制代码
uni.showToast({
  title: "加载中...",
  icon: "loading",
  duration: 3000,
});
无图标提示
javascript 复制代码
uni.showToast({
  title: "这是一条提示信息",
  icon: "none",
  duration: 2000,
});
使用自定义图标
javascript 复制代码
uni.showToast({
  title: "自定义图标",
  image: "/static/icons/custom.png",
  duration: 2000,
});
防止触摸穿透
javascript 复制代码
uni.showToast({
  title: "保存成功",
  icon: "success",
  mask: true,
  duration: 2000,
});

注意事项

  1. uni.showToastuni.showLoading 会共用一个弹窗,如果先后调用,后面的会覆盖前面的
  2. duration 时间到达后会自动关闭提示框
  3. 如果需要手动隐藏提示框,可以调用 uni.hideToast()
  4. 在 App 和 H5 端,mask 属性为 true 时,会阻止用户交互直到提示框消失
  5. 图片大小建议为 40px * 40px

相关 API

  • uni.hideToast(): 隐藏消息提示框
  • uni.showLoading(): 显示加载提示框
  • uni.hideLoading(): 隐藏加载提示框
相关推荐
EndingCoder12 分钟前
类的继承和多态
linux·运维·前端·javascript·ubuntu·typescript
信创天地1 小时前
深耕金融政务核心场景:国产化数据库迁移的全流程架构设计与风险管控
运维·网络安全·系统架构·系统安全·运维开发
ZFB00011 小时前
【麒麟桌面系统】V10-SP1 2503 系统知识——添加用户
linux·运维·kylin
释怀不想释怀1 小时前
Docker(网络)
运维·docker·容器
ZFB00011 小时前
【麒麟桌面系统】V10-SP1 2503 系统知识——进入救援模式
linux·运维·kylin
RisunJan1 小时前
Linux命令-iptables-restore命令(从文件批量恢复 iptables 防火墙规则)
linux·运维·网络
轻造科技2 小时前
周期压缩极限挑战:APS排产优化这样实现
运维·devops
鲨莎分不晴2 小时前
Nginx 部署前端项目实战指南
运维·前端·nginx
java_logo4 小时前
QWEN3 企业级 Docker 容器化部署指南
运维·docker·容器·qwen3部署·qwen3部署文档·qwen3部署教程·qwen3部署方案
糖~醋排骨4 小时前
DHCP服务的搭建
linux·服务器·网络