uni-load-more 加载更多
用于列表中，做滚动加载使用，展示 loading 的各种状态。
# 介绍
# 基本用法
<uni-load-more status="more"></uni-load-more>
1
# API
# LoadMore Props
| 属性名 | 类型 | 可选值 | 默认值 | 说明 |
|---|---|---|---|---|
| iconSize | Number | - | 24 | 指定图标大小 |
| status | String | more/loading/noMore | more | loading 的状态 |
| showIcon | Boolean | - | true | 是否显示 loading 图标 |
| showText | Boolean | - | true | **[1.3.3新增]**是否显示文本 |
| iconType | String | snow/circle/auto | auto | 指定图标样式 |
| color | String | - | #777777 | 图标和文字颜色 |
| contentText | Object | - | {contentdown: "上拉显示更多",contentrefresh: "正在加载...",contentnomore: "没有更多数据了"} | 各状态文字说明 |
# Status Options
| 参数名称 | 说明 |
|---|---|
| more | 加载前 |
| loading | 加载中 |
| no-more | 没有更多数据 |
# IconType Options
| 参数名称 | 说明 |
|---|---|
| snow | ios雪花加载样式 |
| circle | 安卓环形加载样式 |
| auto | 根据平台自动选择加载样式 |
说明
iconType为snow时，在APP-NVUE平台不可设置大小，在非APP-NVUE平台不可设置颜色
# LoadMore Events
| 事件名 | 说明 | 返回值 |
|---|---|---|
| clickLoadMore | 点击加载更多时触发 | e.detail={status:'loading'} |
# 示例
注意
示例依赖了 uni-card uni-section uni-scss 等多个组件，直接拷贝示例代码将无法正常运行 。
请到 组件下载页面 (opens new window) ，在页面右侧选择 使用 HBuilderX导入示例项目 ，体验完整示例演示 (opens new window)。
<template>
<view class="container">
<uni-card is-full :is-shadow="false">
<text class="uni-h6">加载更多组件用于页面加载更多数据时，页面底部显示内容等场景</text>
</uni-card>
<uni-section title="基本用法" type="line">
<uni-load-more :status="status" />
</uni-section>
<uni-section title="修改默认文字" type="line">
<uni-load-more :status="status" :content-text="contentText" />
</uni-section>
<uni-section title="改变颜色" type="line">
<uni-load-more color="#007AFF" :status="status" />
</uni-section>
<uni-section title="指定加载图标样式 - 按平台自动选择样式" type="line">
<uni-load-more iconType="auto" :status="status" />
</uni-section>
<uni-section title="指定加载图标样式 - 环形" type="line">
<uni-load-more iconType="circle" :status="status" />
</uni-section>
<uni-section title="改变组件状态" type="line">
<radio-group class="uni-list" @change="onChange">
<view v-for="(item, index) in statusTypes" :key="index" class="uni-list-item">
<view class="uni-list-item__container">
<view class="uni-list-item__content">
<text class="uni-list-item__content-title">{{ item.text }}</text>
</view>
<view class="uni-list-item__extra">
<radio :value="item.value" :checked="item.checked" />
</view>
</view>
</view>
</radio-group>
</uni-section>
</view>
</template>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
<script>
export default {
components: {},
data() {
return {
status: 'more',
statusTypes: [{
value: 'more',
text: '加载前',
checked: true
}, {
value: 'loading',
text: '加载中',
checked: false
}, {
value: 'noMore',
text: '没有更多',
checked: false
}],
contentText: {
contentdown: '查看更多',
contentrefresh: '加载中',
contentnomore: '没有更多'
}
}
},
methods: {
onChange(e) {
this.status = e.detail.value
},
clickLoadMore(e) {
uni.showToast({
icon: 'none',
title: "当前状态：" + e.detail.status
})
}
}
}
</script>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
<style lang="scss">
.uni-list-item {
border-bottom-style: solid;
border-bottom-width: 1px;
border-bottom-color: #eee;
font-size: 14px;
}
.uni-list-item__container {
/* #ifndef APP-NVUE */
display: flex;
width: 100%;
box-sizing: border-box;
/* #endif */
padding: 12px 15px;
flex: 1;
position: relative;
flex-direction: row;
justify-content: space-between;
align-items: center;
}
.uni-list-item__content-title {
font-size: 14px;
color: #666;
}
</style>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
// Make sure to add code blocks to your code group
编辑此页 (opens new window)
上次更新: 2025/02/01, 02:18:15