---
url: /components/pro/FaLoading.md
---
# FaLoading 加载动画

全屏加载动画组件，基于 SpinKit 提供 12 种加载动画效果。支持函数式调用。

## 使用场景

* 全屏加载动画组件，基于 SpinKit 提供 12 种加载动画效果。支持函数式调用。
* 常见用法：切换加载类型、自定义尺寸、无文字提示。

## API

### 加载类型

支持 12 种加载动画类型：

* `plane` - 平面旋转
* `chase` - 追逐圆点
* `bounce` - 弹跳球
* `wave` - 波浪
* `pulse` - 脉冲
* `flow` - 流动
* `swing` - 摆动
* `circle` - 圆圈
* `circle-fade` - 淡入圆圈
* `grid` - 网格
* `fold` - 折叠
* `wander` - 漫游

### useFaLoading Options

| 参数 | 说明 | 类型 | 默认值 |
|------|------|------|--------|
| type | 加载动画类型 | `'plane' \| 'chase' \| 'bounce' \| 'wave' \| 'pulse' \| 'flow' \| 'swing' \| 'circle' \| 'circle-fade' \| 'grid' \| 'fold' \| 'wander'` | `'plane'` |
| size | 加载动画尺寸 (px) | `number` | `50` |
| text | 加载提示文字 | `string` | `undefined` |

### 返回值

| 属性 | 说明 | 类型 |
|------|------|------|
| close | 关闭加载动画的方法 | `() => void` |

## 注意事项

* 涉及动画、预览或状态反馈时，建议结合实际页面密度控制同屏实例数量与刷新频率。