Loading 加载
uni-appH5微信小程序App
跨端加载指示器,支持尺寸、颜色变体和辅助文案。
何时使用
等待接口返回、提交处理中等需要明确加载反馈的场景。
何时不使用
内容结构可预期的首屏加载优先用 Skeleton;按钮自身加载态用 Button 的 loading prop。
本文档为 uni-app 端组件契约;Web 端同名组件 API 可能略有差异,请以对应包文档为准。下方手机预览实时运行 uni-app H5 演示。
Props
| 名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
size | string:'sm' | 'md' | 'lg' | "md" | 图标尺寸;数字按 px 处理,字符串原样使用(如 '2em') |
variant | string:'primary' | 'white' | "primary" | 加载图标变体,如 spinner / white |
text | string | "" | 加载文案;内联时显示在图标右侧,fullscreen 时显示在图标下方 |
color | string | "\"\"" | 图标颜色,可传 --rn-* 变量;不传时继承上下文色(fullscreen 下自动反白) |
fullscreen | boolean | false | fixed 全屏遮罩居中,用于页面级加载 |
示例
基础用法
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>