uniapp showToast

张大胆2025-06-09 14:13:16

1、案例

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

2、参数介绍

参数	类型	必填	说明
title	String	是	提示的内容，长度与 icon 取值有关。文本在小程序平台最多显示 7 个汉字长度
icon	String	否	图标，有效值为 “success”,“error”,“fail”,“exception”, “loading”, “none”，分别表示显示成功图标、加载中图标和不显示图标。
image	String	否	自定义图标的本地路径（app端暂不支持gif）
mask	Boolean	否	是否显示透明蒙层，防止触摸穿透，默认：false
duration	Number	否	提提示的延迟时间，单位毫秒，默认：1500
position	String	否	纯文本轻提示显示位置，填写有效值后只有 title 属性生效，且不支持通过 uni.hideToast 隐藏。参数详见下方说明。
success	Function	否	接口调用成功的回调函数
fail	Function	否	接口调用失败的回调函数
complete	Function	否	接口调用结束的回调函数（调用成功、失败都会执行）