uni-app x

展示全部

# uni.showLoading(options?)

显示 loading 提示框, 需主动调用 uni.hideLoading 才能关闭提示框。

它是一个悬浮弹出的、非组件内嵌的加载中提示。

# showLoading 兼容性

Web	微信小程序	Android	iOS	iOS uni-app x UTS 插件	HarmonyOS	HarmonyOS(Vapor)
4.0	4.41	3.91	4.11	4.11	4.61	5.0

# 参数

名称

类型

必填

默认值

兼容性

描述

options

ShowLoadingOptions

否

uni.showLoading参数定义

名称

类型

必备

默认值

兼容性

描述

title

string

否

提示的内容，长度与 icon 取值有关。

mask

boolean

否

是否显示透明蒙层，防止触摸穿透，默认：false

success

(res: ShowLoadingSuccess) => void

否

uni.showLoading成功回调函数定义

fail

(res: ShowLoadingFail) => void

否

uni.showLoading失败回调函数定义

complete

(res: any) => void

否

uni.showLoading完成回调函数定义

# ShowLoadingFail 的属性值

名称

类型

必备

默认值

兼容性

描述

errCode

number

是

uni.showLoading失败回调参数

errSubject

string

是

统一错误主题（模块）名称

data

any

否

错误信息中包含的数据

cause

Error

否

源错误信息，可以包含多个错误，详见SourceError

errMsg

string

是

# 参见

# uni.hideLoading(options?)

隐藏 loading 提示框。

# hideLoading 兼容性

Web	微信小程序	Android	iOS	iOS uni-app x UTS 插件	HarmonyOS	HarmonyOS(Vapor)
4.0	4.41	3.91	4.11	4.11	4.61	5.0

# 参数

名称类型必填默认值兼容性描述

options

HideLoadingOptions

否

uni.showLoading参数定义

名称类型必备默认值兼容性描述

loadingPage

UniPage

否

期望隐藏的目标LoadingPage 如果为null 会关闭当前栈顶全部LoadingPage

success

(res: HideLoadingSuccess) => void

否

uni.hideLoading成功回调函数定义

fail

(res: HideLoadingFail) => void

否

uni.hideLoading失败回调函数定义

complete

(res: any) => void

否

uni.hideLoading完成回调函数定义

noConflict

boolean

否

需要基础库： 2.22.1

目前 toast 和 loading 相关接口可以相互混用，此参数可用于取消混用特性

# HideLoadingFail 的属性值

名称

类型

必备

默认值

兼容性

描述

errCode

number

是

uni.showLoading失败回调参数

errSubject

string

是

统一错误主题（模块）名称

data

any

否

错误信息中包含的数据

cause

Error

否

源错误信息，可以包含多个错误，详见SourceError

errMsg

string

是

# 参见

# 通用类型

# GeneralCallbackResult

名称

类型

必备

默认值

兼容性

描述

errMsg

string

是

错误信息

# Bug & Tips

在 Android、iOS、微信小程序、Web 平台，showLoading 是和页面（包括 dialogPage）绑定的。
- 当showLoading执行时，会寻找当前页面栈顶的窗体（包括 dialogPage），找到后进行绑定，然后弹出loading。
- 在弹出loading后，再次打开新页面，新页面会覆盖原页面弹出的 loading。
  - 如需在新页面（包括 dialogPage）弹出 loading，需要再次调用 showLoading
在 HarmonyOS 平台，showLoading 是和 App window 绑定的，目前未与页面关联，当打开新页面时，原页面弹出的 loading 不会被遮挡。
- 未来 harmonyOS 平台也会提供与页面绑定的 showLoading
在所有平台，当前页面（包括 dialogPage）关闭时，弹出的 loading 都会被自动取消
- 如需在dialogPage关闭后，仍然弹出 Loading，需要在关闭dialogPage后再次调用 showLoading