Skip to content

加载组件

加载组件

加载组件用于在页面或元素加载过程中显示加载动画,提供了全屏加载、区域加载和迷你加载多种方式,可自定义文本和样式。

基础用法

最基本的用法是通过v-loading指令在任意元素上添加加载效果,当绑定值为true时显示加载动画。

加载文本

可以添加加载文本说明正在进行的操作,通过loading-text属性设置。

自定义背景

通过设置背景色可以改变加载遮罩的颜色,适合在不同背景下使用。

全屏加载

全屏加载用于整个页面的加载过程,通过API调用方式使用。

迷你加载

迷你加载提供更轻量的加载提示,适合小区域或轻量级操作的加载状态展示。

加载组件 API

指令用法

指令名说明类型默认值
v-loading是否显示加载动画booleanfalse

指令修饰符

修饰符名说明
loading-text加载提示文本
loading-type加载动画类型,可选值: bouncespin
loading-background加载背景颜色

API 方法

方法名说明参数
fullLoading(options)显示全屏加载options: LoadingOptionsType
miniLoading(options)显示迷你加载options: LoadingOptionsType

选项类型

typescript
interface LoadingOptionsType {
  text?: string; // 加载文本
  bgColor?: string; // 背景颜色,默认为半透明白色
  model?: "ring" | "bean"; // 加载动画类型
  delay?: number; // 延迟显示时间(毫秒)
}

样式变量

加载组件使用了以下CSS变量,可通过样式覆盖自定义:

变量名说明默认值
--t-loading-bg-color加载遮罩背景色rgba(255, 255, 255, 0.9)
--t-loading-text-color加载文本颜色#606266
--t-loading-spinner-color加载图标颜色#1890ff

基于MIT许可发布