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(): 隐藏加载提示框
相关推荐
007php0071 小时前
nginx面试之负载均衡的实际经历与配置
运维·数据库·mysql·nginx·面试·职场和发展·负载均衡
q_19132846951 小时前
基于SpringBoot+uniapp+vue.js的货物配送系统
java·vue.js·spring boot·后端·mysql·uni-app·毕业设计
2501_916008891 小时前
Python抓包HTTPS详解:Wireshark、Fiddler、Charles等工具使用教程
python·ios·小程序·https·uni-app·wireshark·iphone
6***v4171 小时前
启动nginx报错nginx [emerg] bind() to 0.0.0.080 failed (98 Address already in use)
运维·nginx
代码栈上的思考1 小时前
Linux 核心基础实操(含远程登录、编辑器、用户管理等)
linux·运维·服务器
刻刻帝的海角1 小时前
uniapp引入qqmap-wx-jssdk实现微信小程序端获取用户当前位置
微信小程序·小程序·uni-app
礼拜天没时间.1 小时前
《Grafana 企业级可视化监控实战指南:从安装、配置到智能告警》:Grafana 使用
linux·运维·信息可视化·zabbix·grafana·监控
工具人55551 小时前
如何确认当前登录的系统是QNX还是Linux
linux·运维·服务器
python百炼成钢1 小时前
46.Linux SPI 驱动
linux·运维·服务器