mirror of
https://gitee.com/ElemeFE/element.git
synced 2024-11-30 11:17:38 +08:00
2.4 KiB
2.4 KiB
element-loading
A element-loading component for Vue.js.
Demo
http://element-component.github.io/element-loading
Installation
npm i element-loading -D
Usage
import Vue from 'vue'
import ElLoading from 'element-loading'
import 'element-theme-chalk/dist/loading.css'
Vue.use(ElLoading)
服务
Loading 还可以以服务的方式调用。引入 Loading 服务:
在需要调用时:
Loading.service(options);
其中 options
参数为 Loading 的配置项,具体见下表。LoadingService
会返回一个 Loading 实例,可通过调用该实例的 close
方法来关闭它:
let loadingInstance = Loading.service(options);
loadingInstance.close();
需要注意的是,以服务的方式调用的全屏 Loading 是单例的:若在前一个全屏 Loading 关闭前再次调用全屏 Loading,并不会创建一个新的 Loading 实例,而是返回现有全屏 Loading 的实例:
let loadingInstance1 = Loading.service({ fullscreen: true });
let loadingInstance2 = Loading.service({ fullscreen: true });
console.log(loadingInstance1 === loadingInstance2); // true
此时调用它们中任意一个的 close
方法都能关闭这个全屏 Loading。
如果完整引入了 Element,那么 Vue.prototype 上会有一个全局方法 $loading
,它的调用方式为:this.$loading(options)
,同样会返回一个 Loading 实例。
Options
参数 | 说明 | 类型 | 可选值 | 默认值 |
---|---|---|---|---|
target | Loading 需要覆盖的 DOM 节点。可传入一个 DOM 对象或字符串;若传入字符串,则会将其作为参数传入 document.querySelector 以获取到对应 DOM 节点 |
object/string | — | document.body |
body | 同 v-loading 指令中的 body 修饰符 |
boolean | — | false |
fullscreen | 同 v-loading 指令中的 fullscreen 修饰符 |
boolean | — | true |
lock | 同 v-loading 指令中的 lock 修饰符 |
boolean | — | false |
text | 显示在加载图标下方的加载文案 | string | — | — |
customClass | Loading 的自定义类名 | string | — | — |
Development
make dev
## test
make test
## build
make build