Skip to content

TIP

🚧 组件库更新通知 🚧:我们正在努力完善我们的组件库。

Loading 加载

加载数据时显示动效。

基础用法

自定义指令 v-loading,只需要绑定 boolean 值即可。

TIP

🔨 施工中:我们的团队正在全力以赴,以确保为您提供最高质量的组件。请稍后再来查看这些组件的最新进展。

自定义加载中组件内容

在绑定了 v-loading 指令的元素上添加 element-loading-text 属性,其值会被渲染为加载文案,并显示在加载图标的下方。 类似地, element-loading-spinnerelement-loading-background 属性分别用来设定 加载图标、背景色值。

TIP

🔨 施工中:我们的团队正在全力以赴,以确保为您提供最高质量的组件。请稍后再来查看这些组件的最新进展。

全屏加载

当使用指令方式时,全屏遮罩需要添加fullscreen修饰符(遮罩会插入至 body 上) 此时若需要锁定屏幕的滚动,可以使用lock修饰符; 当使用服务方式时,遮罩默认即为全屏,无需额外设置。

TIP

🔨 施工中:我们的团队正在全力以赴,以确保为您提供最高质量的组件。请稍后再来查看这些组件的最新进展。

服务方式调用

服务方式调用,可以自定义遮罩的文案,也可以通过 close 方法关闭。

typescript
import { kawaLoading } from "kawa-ui";

需要的时候通过以下方式调用

typescript
kawaLoading.service(options);

LoadingService 会返回一个 Loading 实例,可通过调用该实例的 close 方法来关闭它

typescript
const loading = kawaLoading.service(options);
nextTick(() => {
  loading.close();
});

TIP

以服务的方式调用的全屏 Loading 是单例的。 若在前一个全屏 Loading 关闭前再次调用全屏 Loading,并不会创建一个新的 Loading 实例,而是返回现有全屏 Loading 的实例

Loading API

Options

NameDescriptionTypeDefault
target遮罩绑定的目标元素HTMLElementdocument.body
fullscreen是否为全屏遮罩booleantrue
lock是否锁定屏幕滚动booleanfalse
text加载文案string--
spinner加载图标string--
background遮罩背景色string--

Directive

NameDescriptionType
v-loading是否显示加载动画boolean
kawa-loading-text加载文案string
kawa-loading-spinner加载图标string
kawa-loading-background遮罩背景色string