tmui4x 2.0(Vapor)

主题

TMUI4x2026-09-21
729
2.9m

x-loading-s 全屏加载 ​

居中加载提示，用来替代 uni.showLoading。支持自定义文字、图标和颜色，需手动关闭。

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

兼容性 ​

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

调用 ​

ts
import { showLoading, hideLoading, XLOADINGS_TYPE } from "@/uni_modules/x-loading-s"

showLoading({
  title: "正在提交...",
  success: () => {
    console.log("已弹出")
  }
} as XLOADINGS_TYPE)

// 或不传参
showLoading()

主动关闭：

ts
hideLoading()

方法 ​

名称需要说明
showLoading可选 XLOADINGS_TYPE弹出加载，不传参用默认样式
hideLoading无关闭加载。页面卸载也会自动关
hideXloading无hideLoading 的兼容别名

参数 ​

XLOADINGS_TYPE

字段说明默认
title提示文字""
iconCodeRemix 图标 unicode，如 EEC4。微信不支持EEC4
iconColor图标颜色rgb(5,121,255)
iconSize图标大小 px36
titleSize文字字号 px12
titleColor文字色#a0a1a7
contentBgColor内容底色#ffffff
maskBgColor遮罩色rgba(0,0,0,0.6)
size内容宽度 px，最小高 100100
success弹出成功-
fail弹出失败-
complete调用结束-

没有 close 回调，关闭请调 hideLoading()。页面卸载时会自动隐藏。

平台差异 ​

  1. 微信小程序：uni.showLoading，仅 title 有效（空则 "..."），遮罩固定开启。

版本 ​

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

更新日志 ​

1.1.1（2026-08-14） ​

  • 配置新增 success / fail / complete 回调，对齐 DCloud 函数风格：弹出成功走 success，失败走 fail，两者之后都会走 complete

1.1.0（2026-08-13） ​

  • 重构为与 x-modal-s 一致的 DCloud 函数风格：新增 hideLoading()（对齐 uni.hideLoading 命名），hideXloading 保留为兼容别名
  • showLoading(options?) 支持无参调用，五端签名统一
  • 性能优化：安卓端 remixicon 字体缓存、代次隔离防止重入竞态、Activity 销毁时自动释放弹层防泄漏
  • iOS 端 hide 后释放视图引用并增加代次守卫
  • web 端字体只加载一次，入场动画改用 requestAnimationFrame 触发

1.0.8（2026-04-21） ​

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

1.0.7（2026-01-30） ​

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

1.0.6（2025-08-17） ​

  • 兼容原生鸿蒙

1.0.3（2025-04-13） ​

  • 安卓端修改了布局结构现会覆盖官方的dialog-page了并且会自动隐藏状态栏,并可以覆盖底部安全区域

1.0.2（2025-02-23） ​

  • 安卓添加了显示背景遮罩动画,及关闭遮罩动画
  • ios添加了显示背景遮罩动画,及关闭遮罩动画
  • 上述添加后,不管是显示和关闭都更加的自然

1.0.1（2024-09-06） ​

  • 更新支持Uniapp

1.0.0（2024-08-06） ​

安卓,ios,web可用。

最近更新