`uni.showToast` 是 uni-app 框架提供的一个用于显示消息提示框的 API

uni.showToast 是 uni-app 框架提供的一个用于显示消息提示框的 API,它可以在页面上显示一个浮层展示信息,是一种轻量级提示用户的方式。

使用说明

uni.showToast 可以用来给用户显示简短的消息提示,它会在一段时间后自动消失。可以用于提示成功保存、删除成功等操作反馈。

API 结构

uni.showToast 的基本调用结构如下:

javascript 复制代码
uni.showToast({
  title: '', // 提示的内容
  icon: 'success', // 图标,有效值 "success", "loading", "none"
  image: '', // 自定义图标的本地路径,image 的优先级高于 icon
  duration: 1500, // 提示的延迟时间,单位毫秒,默认:1500
  mask: false, // 是否显示透明蒙层,防止触摸穿透,默认:false
  success: function () {
    // 接口调用成功的回调函数
  },
  fail: function () {
    // 接口调用失败的回调函数
  },
  complete: function () {
    // 接口调用结束的回调函数(调用成功、失败都会执行)
  }
});

示例代码

以下是一个使用 uni.showToast 的示例代码:

javascript 复制代码
uni.showToast({
  title: '操作成功',
  icon: 'success',
  duration: 2000,
  mask: true,
  success: function () {
    console.log('toast显示成功');
  },
  fail: function () {
    console.error('toast显示失败');
  },
  complete: function () {
    console.log('toast执行完成');
  }
});

在这个示例中,调用 uni.showToast 方法显示一个含有文本"操作成功"的提示框,图标为"success",持续时间为 2000 毫秒。

  • title 是提示的内容。
  • icon 是图标,有效值为 "success", "loading", "none",分别表示显示成功图标、加载中图标和不显示图标。
  • image 可以指定自定义图标的本地路径,如果设置了 image,则 icon 的设置将被忽略。
  • mask 设置为 true 表示显示透明蒙层,这样可以防止用户在提示框显示期间与页面上的其他控件交互。

更多详情和参数配置可以查看 uni-app 官方文档

相关推荐
yyt3630458411 小时前
K 线图高性能窗口化渲染
前端·javascript·css·vue.js·gitee·vue
ss2731 小时前
高版本node启动RuoYi-Vue若依前端ruoyi-ui
前端·javascript·vue.js
爱分享的鱼鱼2 小时前
前端密码验证详解:Vue3+Element Plus 方案/纯血Vue 3 方案:从语法解析到实战实现
vue.js·element
我的div丢了肿么办2 小时前
js中worker的详细讲解
前端·javascript·vue.js
+VX:Fegn08952 小时前
计算机毕业设计|基于springboot + vue酒店预约系统(源码+数据库+文档)
数据库·vue.js·spring boot·后端·课程设计
源码获取_wx:Fegn08953 小时前
基于springboot + vue酒店预约系统
java·vue.js·spring boot·后端·spring
天天开心a3 小时前
【Vue错误修复】Vue模块居中问题
java·前端·javascript·vue.js·前端框架·vue
钰衡大师4 小时前
电商后台管理系统:动态路由刷新空白问题分析与解决方案
vue.js·elementui·前端框架
勤奋的小米蜂4 小时前
vscode 自带终端无法正常执行例如npm命令---解决办法
前端·vue.js·vscode·npm
计算机学姐5 小时前
基于SpringBoot的光迹摄影跟拍预约系统【2026最新】
java·vue.js·spring boot·后端·spring·java-ee·mybatis