tmui4x 2.0(Vapor)

主题

TMUI4x2026-09-21
911
3.6m

x-toast-s 轻提示 ​

居中弹出的轻提示，用来替代 uni.showToast。支持超长文字、自定义图标和颜色，连续调用会自动关掉上一条。

微信内使用官方 uni.showToast，图标、颜色、尺寸等样式字段不生效，仅保留签名。

兼容性 ​

HarmonyIOSAndroidWEB小程序
支持支持支持支持支持（官方 Toast）

调用 ​

ts
import { showToast, hideToast, XTOAST_TYPE } from "@/uni_modules/x-toast-s"

showToast({
  title: "保存成功",
  iconCode: "success",
  duration: 2000,
  success: () => {
    console.log("已弹出")
  },
  close: () => {
    console.log("已关闭")
  }
} as XTOAST_TYPE)

方法 ​

名称需要说明
showToastXTOAST_TYPE，title 必填弹出提示，连续调用会关掉上一条
hideToast无立刻关闭当前提示

参数 ​

XTOAST_TYPE

字段说明默认
title标题，必填-
iconCodeRemix 图标 unicode，如 ED29；也可用 warn / error / success / info。微信仅 success / error / loading / noneF449
iconColor图标颜色rgb(5,121,255)
iconSize图标大小 px52
titleSize标题字号 px14
titleColor标题色rgb(5,121,255)
contentBgColor内容底色#ffffff
maskBgColor遮罩色rgba(0,0,0,0.6)
size内容宽度 px130
duration自动关闭毫秒，0 不自动关2000
maskDisableClik拦截遮罩点击。微信映射为 masktrue
success弹出成功-
fail弹出失败-
complete调用结束-
close关闭完成-

平台差异 ​

  1. 微信小程序：uni.showToast，仅 title、duration、maskDisableClik 生效；自定义图标码降级为 none。

版本 ​

版权归https://xui.tmui.design你不得修改及二次开发，仅供TMUI4会员商用使用。不得转给非VIP会员使用，一经查实数倍赔偿，并追究法律责任。

更新日志 ​

1.1.1（2026-08-14） ​

  • 配置新增 success / fail / complete 回调，对齐 DCloud 函数风格：弹出成功走 success，失败走 fail，两者之后都会走 complete；原有 close 仍在消失时触发

1.1.0（2026-08-13） ​

  • 重构为与 x-modal-s 一致的 DCloud 函数风格：showToast(options?) 支持无参调用，五端签名统一
  • 性能优化：安卓端 remixicon 字体缓存（不再每次 show 都读磁盘）、代次隔离防止旧定时器关掉新 toast、Activity 销毁时自动释放弹层防泄漏
  • iOS 端 hide 后释放视图与回调引用，close 回调保证只触发一次
  • web 端修复动画样式因 id 不匹配每次 show 都重复插入 style 标签的问题，字体只加载一次
  • 微信端 options 允许为空，iconCode 非内置图标时自动降级为 none

1.0.8（2026-04-21） ​

  • 修复可能存在的内存泄露风险

1.0.7（2026-01-30） ​

  • 使用了sdk4.65+推出的接口来避免与官方的弹层冲突导致无法显示。

1.0.6（2025-08-17） ​

  • 兼容原生鸿蒙

1.0.5（2025-04-13） ​

  • xToast在安卓,ios,web布局已更新为宽自动,并设定最大宽(之前宽是固定),方便在平板手机内容超多时自动断行及限定最大宽
  • 在安卓端并且会自动隐藏状态栏,并可以覆盖底部安全区域,还可以覆盖住官方的diaglo-page,做到真正的全覆盖
  • 补上close事件

1.0.4（2025-02-23） ​

  • 安卓端重新设定了动画参数,让打开显示的更自然.同时关闭逻辑改成了:当页面卸载或者超时跳转页面时,不会自动关闭上页的问题.
  • ios端添加了显示动画,显示更自然

1.0.3（2025-02-13） ​

  • 兼容微信

1.0.2（2024-09-12） ​

  • 增加了maskDisableClik事件穿透,false表示允许穿透默认是true禁止事件穿透遮罩.

1.0.1（2024-09-06） ​

  • 更新支持Uniapp

1.0.0（2024-08-06） ​

安卓,ios,web可用。

最近更新