Vant3 中文入门教程 Vant3 Loading 加载

2024-02-25 开发教程 Vant3 中文入门教程 匿名 6

介绍

加载图标,用于表示加载中的过渡状态。

实例演示

引入

通过以下方式来全局注册组件,更多注册方式请参考组件注册。

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" />

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加载文案

样式变量

组件提供了下列 CSS 变量,可用于自定义样式,使用方法请参考 ConfigProvider 组件。

名称默认值描述
--van-loading-text-color

var(--van-gray-6)

-
--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-animation-duration

0.8s

-