加载中 Loading

当区域正在获取数据时使用,提高用户体验。

该组件支持wx.lin用法。

加载类型

可通过加载组件的type属性设置加载动画类型。并通过 设置showtrue 或者 false 来控制它的显示与隐藏。

type共有五种状态,可选值为flashflipchangecirclerotate,可根据使用场景选择合适的类型,默认为rotate

示例代码

  1. <l-loading show="{{true}}" type="flash"></l-loading>
  2. <l-loading show="{{true}}" type="flip"></l-loading>
  3. <l-loading show="{{true}}" type="change"></l-loading>
  4. <l-loading show="{{true}}" type="circle"></l-loading>
  5. <l-loading show="{{true}}" type="rotate"></l-loading>

不同类型

加载动画大小

设置组件size属性可更改加载动画的大小。

size的可选值为minimediumlarge,默认为medium

示例代码

  1. <l-loading show="{{true}}" size="mini"></l-loading>
  2. <l-loading show="{{true}}" size="medium"></l-loading>
  3. <l-loading show="{{true}}" size="large"></l-loading>

不同大小

自定义加载动画颜色

设置组件的color属性更改加载动画的颜色。默认颜色与主题色(theme_color)一致。

示例代码

  1. <l-loading show="{{true}}" color="#666"></l-loading>

不同颜色

自定义加载动画

为适应不同的场景和需求,组件的内容部分(动画)可以通过自定义的方式来实现。

设置组件的custom属性为 true ,自定义内容在slot插槽中写入即可。也支持传入一个包含文字+image的子节点。

注意事项

  • loading组件只接收一个slot作为子节点,但你可以在这个子节点内添加更多的标签和内容

示例代码

  1. <l-loading show="{{true}}" custom="{{true}}">
  2. <image src="/image/view/spin.gif"></image>
  3. </l-loading>

自定义加载动画

全屏状态下的Loading

在开发工作的中,我们会遇到一种常见的场景:当跳转到一个新页面时,开始加载数据,全屏显示loading,当数据加载完成时,隐藏loading。

针对这种场景,我们可以通过设置 full-screen 属性为 true ,并配合外部样式类 l-container-class 来完成,也可以使用bg-colorz-indexopacity属性来设置全屏状态下的背景颜色、层级和背景透明度。

注意事项

  • 全屏模式下可以设置 type 值来指定不同的加载动画,同样也可以使用自定义的 slot
  • l-container-class 无法改变loading背景的 positionheightwidth 属性。

示例代码

  1. <l-loading
  2. l-container-class="l-container"
  3. bg-color="#f3f3f3"
  4. z-index="776"
  5. opacity="1"
  6. show="{{show}}"
  7. full-screen="{{true}}"
  8. custom="{{true}}"
  9. >
  10. <image class="loading-img" src="/image/static/loading.gif"></image>
  11. </l-loading>

全屏幕自定义加载动画

固定Loading区域

示例代码

  1. <l-loading
  2. l-container-class="l-container"
  3. bg-color="#f3f3f3"
  4. z-index="776"
  5. opacity="1"
  6. show="{{show}}"
  7. full-screen="{{false}}"
  8. custom="{{true}}"
  9. >
  10. <image class="loading-img" src="/image/static/loading.gif"></image>
  11. <view slot="content" style="height: 600rpx; width:100%"></view>
  12. </l-loading>

加载中属性(Loading Attributes)

参数说明类型可选值默认值
show是否显示加载动画Boolean——false
type加载动画类型Stringflash/flip/change/rotate/circlerotate
size加载动画大小Stringmini/medium/largemedium
color加载动画颜色String——-——
z-index加载动画层级String——-776
custom加载动画(内容部分)是否自定义Boolean——-false
full-screen加载动画(内容部分)是否全屏Boolean——-false
bg-color加载动画背景颜色(全屏模式)String——-——
opacity加载动画背景透明度String——-1

加载中插槽 (Loading Slot)

插槽名称说明备注
-自定义loading图标—-
content非全屏模式下主体内容区域loading组件将包裹在content插槽外部

加载中外部样式类(Loading ExternalClasses)

外部样式类名说明备注
l-class覆盖动画区域(内容部分)自定义外部样式类—-
l-container-class覆盖背景部分的自定义外部样式类—-