跳到主要内容

Loading 加载 ​

uni-appH5微信小程序App

跨端加载指示器,支持尺寸、颜色变体和辅助文案。

何时使用 ​

等待接口返回、提交处理中等需要明确加载反馈的场景。

何时不使用 ​

内容结构可预期的首屏加载优先用 Skeleton;按钮自身加载态用 Button 的 loading prop。

本文档为 uni-app 端组件契约;Web 端同名组件 API 可能略有差异,请以对应包文档为准。下方手机预览实时运行 uni-app H5 演示。

9:41
Loading 加载 · uni-app H5 实时运行 新窗口打开

Props ​

名称类型默认值说明
sizestring:'sm' | 'md' | 'lg'"md"图标尺寸;数字按 px 处理,字符串原样使用(如 '2em')
variantstring:'primary' | 'white'"primary"加载图标变体,如 spinner / white
textstring""加载文案;内联时显示在图标右侧,fullscreen 时显示在图标下方
colorstring"\"\""图标颜色,可传 --rn-* 变量;不传时继承上下文色(fullscreen 下自动反白)
fullscreenbooleanfalsefixed 全屏遮罩居中,用于页面级加载

示例 ​

基础用法 ​

vue
<Loading text="加载中" />

尺寸 ​

vue
<view class="row">
  <Loading size="sm" />
  <Loading size="md" />
  <Loading size="lg" />
</view>

深色背景反白 ​

vue
<view class="dark-box">
  <Loading variant="white" text="提交中" />
</view>

自定义颜色 ​

vue
<view class="row">
  <Loading color="#3b6ef6" />
  <Loading color="#ec4899" text="加载中" />
</view>