Skip to content

x-tips-s 消息提示

顶部或底部的全局文字提示,不打断当前操作,可自动消失。连续调用会自动关掉上一条。

微信内使用官方 uni.showToast,位置、偏移、自定义图标不生效,仅保留签名。

兼容性

HarmonyIOSAndroidWEB小程序
支持支持支持支持支持(官方 Toast)

调用

ts
import { showTips, hideTips, XTIPS_TYPE } from "@/uni_modules/x-tips-s"

showTips({
  title: "顶部提示消息",
  iconCode: "info",
  position: "top",
  offset: 50,
  duration: 2000
} as XTIPS_TYPE)

方法

名称需要说明
showTipsXTIPS_TYPEtitle 必填弹出顶部或底部提示,连续调用会关掉上一条
hideTips立刻关闭当前提示

参数

XTIPS_TYPE

字段说明默认
title标题,必填-
iconCodeRemix 图标 unicode,如 ED29;也可用 warn / error / success / info。微信不支持F449
iconColor图标颜色rgb(5,121,255)
iconSize图标大小 px20
titleSize标题字号 px16
titleColor标题色rgb(5,121,255)
contentBgColor内容底色#ffffff
maskBgColor遮罩色透明
size内容宽度 px130
duration自动关闭毫秒,0 不自动关2000
positiontop / bottom。微信不支持top
offset距顶/底偏移 px。微信不支持50
maskDisableClik拦截遮罩点击false
success弹出成功-
fail弹出失败-
complete调用结束-
close关闭完成-

平台差异

  1. 微信小程序:uni.showToast,仅 titledurationmaskDisableClikclose 生效。

版本

版权归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 函数风格:showTips(options?) 支持无参调用,五端签名统一
  • 新增微信小程序端降级实现(wx.showToast 对齐 title/duration/close 语义)
  • 性能优化:安卓端 remixicon 字体缓存、代次隔离防止旧定时器关掉新 tips
  • iOS 端修复内容渐显动画被重复添加为缩放动画的问题;hide 后释放视图与回调引用,close 只触发一次
  • web 端修复动画样式因 id 不匹配每次 show 都重复插入 style 标签的问题,字体只加载一次

1.0.4(2026-04-21)

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

1.0.3(2026-01-30)

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

1.0.2(2025-07-25)

  • 更新支持鸿蒙原生 Next,采用自己编译的 Har 包来支持

1.0.1(2025-02-23)

  • 更新了动画,并修复了,如果路径页面,上个页面不会自动关闭的问题.
  • ios端添加了显示动画,显示更自然

1.0.0(2024-08-06)

安卓,ios,web可用。

最近更新