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(): 隐藏加载提示框
相关推荐
_运维那些事儿19 小时前
VM环境的CI/CD
linux·运维·网络·阿里云·ci/cd·docker·云计算
Trouvaille ~20 小时前
【Linux】UDP Socket编程实战(一):Echo Server从零到一
linux·运维·服务器·网络·c++·websocket·udp
嵌入小生00720 小时前
Shell | 命令、编程及Linux操作系统的基本概念
linux·运维·服务器
-Try hard-21 小时前
Linuv软件编程 | Shell命令
linux·运维·服务器
释怀不想释怀21 小时前
Linux快捷键,软件安装启动
linux·运维·服务器
zhengfei61121 小时前
自动化快速评估工具
运维·自动化
Hello World . .21 小时前
Linux:软件编程
linux·运维·服务器·vim
老师用之于民1 天前
【DAY21】Linux软件编程基础&Shell 命令、脚本及系统管理实操
linux·运维·chrome·经验分享·笔记·ubuntu
路由侠内网穿透.1 天前
本地部署代码托管解决方案 Gitea 并实现外部访问( Windows 版本)
运维·服务器·网络协议·gitea
serve the people1 天前
python环境搭建 (十三) tenacity重试库
服务器·python·php