更新记录
2.0.4(2021-02-07) 下载此版本
- 新增 animation参数,支持多种加载动画效果
- 新增 under-color参数,指定底层文字颜色
- 新增 highlight-color参数,指定高亮文字颜色
2.0.3(2021-02-03) 下载此版本
修复H5上不显示加载文字的问题
2.0.2(2021-01-14) 下载此版本
修复微信小程序上不显示加载文字的问题
查看更多平台兼容性
Vue2 | Vue3 |
---|---|
√ | × |
App | 快应用 | 微信小程序 | 支付宝小程序 | 百度小程序 | 字节小程序 | QQ小程序 |
---|---|---|---|---|---|---|
HBuilderX 3.1.0 app-vue app-nvue | × | √ | × | × | × | × |
钉钉小程序 | 快手小程序 | 飞书小程序 | 京东小程序 | 鸿蒙元服务 |
---|---|---|---|---|
× | × | × | × | × |
H5-Safari | Android Browser | 微信浏览器(Android) | QQ浏览器(Android) | Chrome | IE | Edge | Firefox | PC-Safari |
---|---|---|---|---|---|---|---|---|
√ | √ | √ | √ | √ | √ | √ | √ | √ |
说明
本组件通常用于页面数据需要异步加载时,为避免出现数据加载完毕之前页面上出现空数据的尴尬情况,显示loading层作为页面载入过渡。 使用时在想要使用的页面引入即可,它不会影响你页面中原有的布局。
插件引入前必看,重要! 重要! 重要!
如果你的项目是uni_modules规范可以点击[使用HBuilderX导入插件]直接引入
如果你的项目不是uni_modules规范,请点击[下载插件ZIP]到本地,手动解压后引入
以上两种使用方式均针对uni_modules版本,非uni_modules版本中的代码是老版本,不要下载了,引入或下载前请看好^-^
用法示例
<template>
<view>
<ls-loading text="now loading..." :animation="animation" v-if="pageLoading"></ls-loading>
<!-- 下面照常写你的页面布局 -->
</view>
</template>
// uni_modules规范模式下的引入方式:
import lsLoading from '@/uni_modules/ls-loading/components/ls-loading/ls-loading.vue';
// 非uni_modules规范模式下的引用方式:
// import lsLoading from '@/components/ls-loading/ls-loading.vue';
export default {
components: {
lsLoading
},
data() {
return {
pageLoading: true,
animation: 'twinkle'
}
},
onLoad() {
// 这里模拟接口请求,接口请求成功后将pageLoading改为false
setTimeout(() => {
this.pageLoading = false;
}, 3000);
}
}
组件参数
属性名 | 类型 | 默认值 | 说明 |
---|---|---|---|
nav | Boolean |
false |
是否预留出标题栏的高度(可用于自定义标题栏页面) |
tab | Boolean |
false |
是否预留出tabBar的高度(可用于自定义tabbar页面) |
embed | Boolean |
false |
是否为嵌入模式(该模式采用非绝对定位布局,实际位置根据页面布局而定) |
text | String |
正在加载 |
加载中的文字 |
fontSize | String 或Number |
58 (单位rpx) |
加载中文字大小 |
animation | String |
twinkle |
动画类型,详细说明请看下方animation参数说明 |
under-color | String |
#e8e7e8 |
底层文字颜色,注意不同的动画类型对此参数的支持有差异,具体请参照animation参数说明 |
highlight-color | String |
#00bfff |
高亮文字颜色,注意不同的动画类型对此参数的支持有差异,具体请参照animation参数说明 |
animation参数说明
类型 | 说明 | 是否支持under-color | 是否支持highlight-color |
---|---|---|---|
twinkle |
文字闪烁效果 | 否 |
否 |
focus |
文字聚焦效果 | 否 |
否 |
rise |
模拟水位上涨效果 | 是 |
是 |
progress |
水平进度加载效果 | 是 |
是 |
jump |
文字跳动效果 | 是 |
否 |
效果预览
联系作者
如有问题或建议欢迎在下方留言,也可以添加我的QQ:2424044437