Skip to content

Loading 加载

预览
01:38

组件名:rice-loading

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

平台兼容性

uni-app x

AndroidiOS鸿蒙Next微信小程序h5

基础用法

通过 mode 属性设置加载的类型

html
<rice-loading />
<rice-loading mode="circle" />
<rice-loading mode="semicircle" />
<rice-loading mode="snow" />

自定义颜色

通过 color 属性可以修改颜色

html
<rice-loading color="#ed6a0c" />
<rice-loading color="#67c23a" mode="circle" />
<rice-loading color="#ee0a24" mode="semicircle" />
<rice-loading color="#e6a23c" mode="snow" />

自定义大小

通过 size 属性可以设置加载图标的大小

html
<rice-loading size="28" />

动画类型

通过 timing-function 可以设置加载动画的类型,modecirclesemicircle 时才有效

html
<rice-loading mode="circle" timing-function="linear" />
<rice-loading mode="semicircle" timing-function="linear" />

加载文案

通过 text 属性设置加载文案

html
<rice-loading text="加载中…" />
<rice-loading vertical>加载中…</rice-loading>

自定义文案颜色和大小

html
<rice-loading mode="circle" vertical text="加载中…" color="#fd5530" text-color="#fd5530" text-size="12px" />

自定义图标

html
<rice-loading mode="circle" timing-function="ease-in" :duration="1500">
  <template #icon>
    <rice-icon name="star" size="26" color="#ee0a24" />
  </template>
</rice-loading>

API

Props

属性名类型说明默认值
modeString类型,可选值:circular、snow、semicircle、circlecircular
durationNumber过渡时间,单位ms1000
colorString颜色-
inactive-colorString图标的暗边颜色, mode为circle 模式有效-
sizeString|Number加载图标大小24px
textString|Number加载文字-
text-colorString文字颜色-
text-sizeString| Number文字大小14px
verticalBoolean是否垂直排列图标和文字内容 默认false-
timing-functionString指定animation-timing-function的css属性,mode为circle或semicircle时有效ease-in-out
custom-styleObject自定义style-

TimingFunction Options

属性值说明
ease缓入快出(结束时减速)
ease-in仅缓入(开始慢,逐渐加速)
ease-out仅缓出(开始快,逐渐减速)
ease-in-out缓入缓出(两头慢,中间快)
linear匀速运动

Slots

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

类型定义

组件导出如下类型

ts
import {LoadingMode, LoadingTimingFunction,LoadingProps } from '@/uni_modules/rice-ui'
// 组件类型
const loadingRef = ref<RiceLoadingComponentPublicInstance | null>(null)