Vant4 Loading 加载
介绍
加载图标，用于表示加载中的过渡状态。
引入
通过以下方式来全局注册组件，更多注册方式请参考组件注册。
import { createApp } from 'vue';
import { Loading } from 'vant';
const app = createApp();
app.use(Loading);
代码演示
加载类型
通过 type 属性可以设置加载图标的类型，默认为 circular，可选值为 spinner。
<van-loading />
<van-loading type="spinner" />
自定义颜色
通过 color 属性设置加载图标的颜色。
<van-loading color="#1989fa" />
<van-loading type="spinner" color="#1989fa" />
自定义大小
通过 size 属性设置加载图标的大小，默认单位为 px。
<van-loading size="24" />
<van-loading type="spinner" size="24px" />
加载文案
可以使用默认插槽在图标的右侧插入加载文案。
<van-loading size="24px">加载中...</van-loading>
垂直排列
设置 vertical 属性后，图标和文案会垂直排列。
<van-loading size="24px" vertical>加载中...</van-loading>
自定义文案颜色
通过 color 或者 text-color 属性设置加载文案的颜色。
<!-- 可修改文案和加载图标的颜色 -->
<van-loading color="#0094ff" />
<!-- 只修改文案颜色 -->
<van-loading text-color="#0094ff" />
自定义图标
通过 icon 插槽可以自定义加载图标。
<van-loading vertical>
<template #icon>
<van-icon name="star-o" size="30" />
</template>
加载中...
</van-loading>
API
Props
| 参数 | 说明 | 类型 | 默认值 |
|---|---|---|---|
| color | 颜色 | string | #c9c9c9
|
| type | 类型，可选值为 spinner
|
string | circular
|
| size | 加载图标大小，默认单位为 px
|
number | string | 30px
|
| text-size | 文字大小，默认单位为 px
|
number | string | 14px
|
| text-color | 文字颜色 | string | #c9c9c9
|
| vertical | 是否垂直排列图标和文字内容 | boolean | false
|
Slots
| 名称 | 说明 |
|---|---|
| default | 加载文案 |
| icon | 自定义加载图标 |
类型定义
组件导出以下类型定义：
import type { LoadingType, LoadingProps } from 'vant';
主题定制
样式变量
组件提供了下列 CSS 变量，可用于自定义样式，使用方法请参考 ConfigProvider 组件。
| 名称 | 默认值 | 描述 |
|---|---|---|
| --van-loading-text-color | var(--van-text-color-2) | - |
| --van-loading-text-font-size | var(--van-font-size-md) | - |
| --van-loading-spinner-color | var(--van-gray-5) | - |
| --van-loading-spinner-size | 30px | - |
| --van-loading-spinner-duration | 0.8s | - |