x-tips-s 消息提示
顶部或底部的全局文字提示,不打断当前操作,可自动消失。连续调用会自动关掉上一条。
微信内使用官方 uni.showToast,位置、偏移、自定义图标不生效,仅保留签名。
兼容性
| Harmony | IOS | Android | WEB | 小程序 |
|---|---|---|---|---|
| 支持 | 支持 | 支持 | 支持 | 支持(官方 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)方法
| 名称 | 需要 | 说明 |
|---|---|---|
| showTips | XTIPS_TYPE,title 必填 | 弹出顶部或底部提示,连续调用会关掉上一条 |
| hideTips | 无 | 立刻关闭当前提示 |
参数
XTIPS_TYPE
| 字段 | 说明 | 默认 |
|---|---|---|
| title | 标题,必填 | - |
| iconCode | Remix 图标 unicode,如 ED29;也可用 warn / error / success / info。微信不支持 | F449 |
| iconColor | 图标颜色 | rgb(5,121,255) |
| iconSize | 图标大小 px | 20 |
| titleSize | 标题字号 px | 16 |
| titleColor | 标题色 | rgb(5,121,255) |
| contentBgColor | 内容底色 | #ffffff |
| maskBgColor | 遮罩色 | 透明 |
| size | 内容宽度 px | 130 |
| duration | 自动关闭毫秒,0 不自动关 | 2000 |
| position | top / bottom。微信不支持 | top |
| offset | 距顶/底偏移 px。微信不支持 | 50 |
| maskDisableClik | 拦截遮罩点击 | false |
| success | 弹出成功 | - |
| fail | 弹出失败 | - |
| complete | 调用结束 | - |
| close | 关闭完成 | - |
平台差异
- 微信小程序:
uni.showToast,仅title、duration、maskDisableClik、close生效。
版本
版权归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可用。
