Loading 加载

2022-12-04 11:31| 来源: 网络整理| 查看: 265

Loading 加载 #

加载数据时显示动效。

区域加载 #

在需要的时候展示加载动画，防止页面失去响应提高用户体验（例如表格）。

自定义加载中组件内容 #

你可以自定义加载中组件的文字，图标，以及背景颜色。

WARNING

虽然 element-loading-spinner / element-loading-svg 属性支持传入的 HTML 片段，但是动态在网站上渲染任意的 HTML 是非常危险的，因为很容易导致 XSS 攻击。请确保 element-loading-spinner / element-loading-svg的内容是可信的，不要将用户提交的内容赋值给 element-loading-spinner / element-loading-svg 属性。

让加载组件铺满整个屏幕 #

加载数据时显示全屏动画。

以服务的方式来调用 #

Loading 还可以以服务的方式调用。你可以像这样引入 Loading 服务：

import { ElLoading } from 'element-plus'

在你需要的时候通过下面的方式调用：

ElLoading.service(options)

其中options参数为 Loading 的配置项，具体见下表。 LoadingService 会返回一个 Loading 实例，可通过调用该实例的 close 方法来关闭它：

const loadingInstance = ElLoading.service(options) nextTick(() => { // Loading should be closed asynchronously loadingInstance.close() })

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

const loadingInstance1 = ElLoading.service({ fullscreen: true }) const loadingInstance2 = ElLoading.service({ fullscreen: true }) console.log(loadingInstance1 === loadingInstance2) // true

此时调用它们中任意一个的 close 方法都能关闭这个全屏 Loading。

如果完整引入了 Element Plus，那么 app.config.globalProperties 上会有一个全局方法$loading，它的调用方式为：this.$loading(options)，同样会返回一个 Loading 实例。

配置项 #属性说明类型可选值默认值targetLoading 需要覆盖的 DOM 节点。可传入一个 DOM 对象或字符串；若传入字符串，则会将其作为参数传入 document.querySelector以获取到对应 DOM 节点object/string—document.bodybody同 v-loading 指令中的 body 修饰符boolean—falsefullscreen同 v-loading 指令中的 fullscreen 修饰符boolean—truelock同 v-loading 指令中的 lock 修饰符boolean—falsetext显示在加载图标下方的加载文案string——spinner自定义加载图标类名string——background遮罩背景色string——custom-classLoading 的自定义类名string——指令 #名称说明类型v-loading是否显示动画booleanelement-loading-text显示在加载图标下方的加载文案stringelement-loading-spinner自定义加载图标stringelement-loading-svg自定义加载图标 (与 element-loading-spinner 相同)stringelement-loading-background背景遮罩的颜色string源代码 #

组件 • 文档

贡献者 #