Skip to main content
Version: 3.x

Taro.showLoading(option)

Displays the loading prompt box. Taro.hideLoading must be called to close the prompt box.

Note

  • Either Taro.showLoading or Taro.showToast can be displayed.
  • Taro.showLoading should be paired with Taro.hideLoading.

Reference

Type

(option: Option) => Promise<CallbackResult>

Parameters

Option

PropertyTypeRequiredDescription
titlestringYesPrompt content
maskbooleanNoIndicates whether to display a transparent mask to prevent touch penetration
complete(res: CallbackResult) => voidNoThe callback function used when the API call completed (always executed whether the call succeeds or fails)
fail(res: CallbackResult) => voidNoThe callback function for a failed API call
success(res: CallbackResult) => voidNoThe callback function for a successful API call

Sample Code

Taro.showLoading({
title: 'loading',
})
setTimeout(function () {
Taro.hideLoading()
}, 2000)

API Support

APIWeChat Mini-ProgramH5React Native
Taro.showLoading✔️✔️✔️