Loading 加载

介绍

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

代码演示

加载类型

通过 type 属性可以设置加载图标的类型,默认为 circular,可选值为 spinner

<z-loading />

<z-loading type="spinner" />

自定义颜色

通过 color 属性设置加载图标的颜色。

<z-loading color="#1989fa" />

<z-loading type="spinner" color="#1989fa" />

自定义大小

通过 size 属性设置加载图标的大小,默认单位为 px

<z-loading size="24" />

<z-loading type="spinner" size="48rpx" />

加载文案

可以使用默认插槽在图标的右侧插入加载文案。

<z-loading size="48rpx">加载中...</z-loading>

垂直排列

设置 vertical 属性后,图标和文案会垂直排列。

<z-loading size="48rpx" vertical>加载中...</z-loading>

自定义文案颜色

通过 color 或者 text-color 属性设置加载文案的颜色。

<!-- 可修改文案和加载图标的颜色 -->
<z-loading color="#0094ff" />

<!-- 只修改文案颜色 -->
<z-loading text-color="#0094ff" />

自定义图标

通过 icon 插槽可以自定义加载图标。

<z-loading vertical>
  <template #icon>
    <z-icon name="undo" size="30" />
  </template>
  加载中...
</z-loading>

API

Props

参数说明类型默认值
color颜色string#c9c9c9
type类型,可选值为 spinnerstringcircular
size加载图标大小,默认单位为 pxnumber | string60rpx
text-size文字大小,默认单位为 pxnumber | string28rpx
text-color文字颜色string#c9c9c9
vertical是否垂直排列图标和文字内容booleanfalse

Slots

名称说明
default加载文案
icon自定义加载图标

主题定制

样式变量

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

名称默认值描述
--z-loading-text-colorvar(--z-text-color-2)-
--z-loading-text-font-sizevar(--z-font-size-md)-
--z-loading-spinner-colorvar(--z-gray-5)-
--z-loading-spinner-size60rpx-
--z-loading-spinner-duration0.8s-