本章介绍

本章主要介绍 ArkUI 开发中最常用的场景下拉刷新, 上拉加载，在本章中介绍的内容在实际开发过程当中会高频的使用,所以同学们要牢记本章的内容。下面就让我们开始今天的讲解吧！

List 组件

在 ArkUI 中List容器组件也可以实现数据滚动的效果， 这里为什么先介绍 List 组件，因为在本章节介绍的下拉刷新和上拉加载用到了从此组件，所以一起讲解一下。

语法

<code>List(){

ListItem(){

}

}

注意: 在 List 组件中必须包含 ListItem 子组件才能正常渲染数据，可以理解为每一个 ListItem 对应的就是一条数据。

示例

<code>@Entry

@Component

struct ListDemoPage {

build() {

Column() {

List() {

ListItem() {

Row() {

Text('测试数据 List')

}

.padding(10)

.width('100%')

}

ListItem() {

Row() {

Text('测试数据 List')

}

.padding(10)

.width('100%')

}

ListItem() {

Row() {

Text('测试数据 List')

}

.padding(10)

.width('100%')

}

ListItem() {

Row() {

Text('测试数据 List')

}

.padding(10)

.width('100%')

}

ListItem() {

Row() {

Text('测试数据 List')

}

.padding(10)

.width('100%')

}

}

.height(100)

.divider({strokeWidth:1,color:"#ededed"})

}

.height('100%')

.width('100%')

}

}

我们发现当页面元素超出了List组件设置的高度，屏幕上就会出现滚动条，并且下拉画面数据到顶部的时候，画面整体也会被下拉。并且上述代码有重复代码，这时我们就可以使用上一章节讲解的循环渲染ForEach组件去渲染列表让我们改造一下代码。

<code>@Entry

@Component

struct ListDemoPage {

// 定义一个类型为number，长度为 30 的数组，并且放入数据，数据为当前时间戳

@State

data:number[] = new Array(30).fill(Date.now())

build() {

Column() {

// 使用 List 组件

List() {

// 循环渲染

ForEach(this.data,(item:number)=>{

// 必须使用 ListItem 组件进行包裹

ListItem() {

Row() {

Text(item+"")

}

.padding(10)

.width('100%')

}

})

}

.height('100%')

.divider({strokeWidth:1,color:"#ededed"})

}

.height('100%')

.width('100%')

}

}

下面我们实现下拉刷新添加数据

Refresh 组件

Refresh可以进行页面下拉操作并显示刷新动效的容器组件。Refresh子组件会跟随手势下拉而下移。我们使用这个组件将我们上面的代码进行包裹。

语法

Refresh(){

}

介绍一下 可以往Refresh组件传递的参数（先介绍两个）

●refreshing：当前组件是否正在刷新。支持双向绑定

●builder：下拉时，自定义刷新样式的组件。可以自定义下拉刷新样式。

下拉刷新

下面让我们使用Refresh组件实现下拉刷新的功能。

示例

<code>@Entry

@Component

struct ListDemoPage {

// 定义数据

@State

data:number[] = new Array(30).fill(Date.now())

// 定义刷新状态 flag

@State

private refreshingFlag: boolean = false;

// 自定义下刷新页面

@Builder

private LoadingCustom() {

Stack() {

Row() {

// Loading 组件

LoadingProgress().width(30).color("#4095cb")

}

}.width('100%')

}

build() {

Column() {

// 使用刷新组件

Refresh({ refreshing: $$this.refreshingFlag, builder: this.LoadingCustom() }) {

List() {

ForEach(this.data, (item: number) => {

ListItem() {

Row() {

Text(item + "")

}

.padding(10)

.width('100%')

}

})

}

.height('100%')

.divider({ strokeWidth: 1, color: "#ededed" })

}

// 进入刷新状态时触发回调。这里两后停止刷新状态

.onRefreshing(() => {

setTimeout(() => {

this.refreshingFlag = false

}, 2000)

})

// 设置触发刷新的下拉偏移量。

.refreshOffset(64)

// 设置当下拉距离超过refreshOffset时是否触发刷新。

.pullToRefresh(true)

}

.height('100%')

.width('100%')

}

}

上述代码中使用@builder 装饰器修饰的内容可以理解为一个子画面，实现了自定义刷新页面，本章先不过多的说@builder 的作用。

现在只需在onRefreshing的方法中新增 List 的数据即可。

.onRefreshing(() => {

setTimeout(() => {

this.refreshingFlag = false

// 添加数据

this.data.push(...Array(30).fill(Date.now()))

}, 2000)

})

效果：

如上图所示，每次下拉刷新后画面会新增 30 条数据。

上拉加载

Refresh组件中没有提供上拉加载的功能，我们可以结合 List 组件的事件来实现此功能。

示例

我们发现当页面的滚动条触底时，会触发加载数据的事件，此时我们需要在代码中知道当前滚动条的状态。

<code>import { promptAction } from '@kit.ArkUI';

@Entry

@Component

struct ListDemoPage {

@State

data:number[] = new Array(30).fill(Date.now())

@State

private refreshingFlag: boolean = false;

// 判断滚动条是否触底

@State

private isEnd: boolean = false;

// 使用Scroller对象

scroller: Scroller = new Scroller();

@Builder

private LoadingCustom() {

Stack() {

Row() {

LoadingProgress().width(30).color("#4095cb")

}

}.width('100%')

}

build() {

Column() {

Refresh({ refreshing: $$this.refreshingFlag, builder: this.LoadingCustom() }) {

List() {

ForEach(this.data, (item: number) => {

ListItem() {

Row() {

Text(item + "")

}

.padding(10)

.width('100%')

}

})

}

.height('100%')

.divider({ strokeWidth: 1, color: "#ededed" })

// 当画面能滚动说明没有触底

.onScrollStart(() => {

this.isEnd = false

})

// 判断当前是否停止滚动

.onScrollStop(() => {

// 如果停止滚动并且满足滚动条已经在底部进行数据的加载。

if (this.isEnd) {

// 加载数据

promptAction.showToast({ message: '加载数据' })

setTimeout(()=>{

this.data.push(...Array(30).fill(Date.now()))

// 加载完数据把滚动条移至底部

this.scroller.scrollEdge(Edge.Bottom)

},1000)

}

})

// 当滚动条触底把 flag 设置成 true

.onReachEnd(() => {

this.isEnd = true

})

}

.onRefreshing(() => {

setTimeout(() => {

this.refreshingFlag = false

this.data.push(...Array(30).fill(Date.now()))

}, 2000)

})

.refreshOffset(64)

.pullToRefresh(true)

}

.height('100%')

.width('100%')

}

}

写在最后

有很多小伙伴不知道学习哪些鸿蒙开发技术？不知道需要重点掌握哪些鸿蒙应用开发知识点？而且学习时频繁踩坑，最终浪费大量时间。所以有一份实用的鸿蒙（HarmonyOS NEXT）文档用来跟着学习是非常有必要的。

这份鸿蒙（HarmonyOS NEXT）文档包含了鸿蒙开发必掌握的核心知识要点，内容包含了（ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、OpenHarmony南向开发、鸿蒙项目实战等等）鸿蒙（HarmonyOS NEXT）技术知识点。

希望这一份鸿蒙学习文档能够给大家带来帮助，有需要的小伙伴自行领取，限时开源，先到先得~无套路领取！！

获取这份完整版高清学习路线，请点击→纯血版全套鸿蒙HarmonyOS学习文档

鸿蒙（HarmonyOS NEXT）5.0最新学习路线

有了路线图，怎么能没有学习文档呢，小编也准备了一份联合鸿蒙官方发布笔记整理收纳的一套系统性的鸿蒙（OpenHarmony ）学习手册（共计1236页）与鸿蒙（OpenHarmony ）开发入门教学视频，内容包含：ArkTS、ArkUI、Web开发、应用模型、资源分类…等知识点。

获取以上完整版高清学习路线，请点击→纯血版全套鸿蒙HarmonyOS学习文档

《鸿蒙 (OpenHarmony)开发入门教学视频》

《鸿蒙生态应用开发V3.0白皮书》

《鸿蒙 (OpenHarmony)开发基础到实战手册》

OpenHarmony北向、南向开发环境搭建

《鸿蒙开发基础》

●ArkTS语言

●安装DevEco Studio

●运用你的第一个ArkTS应用

●ArkUI声明式UI开发

.……

《鸿蒙开发进阶》

●Stage模型入门

●网络管理

●数据管理

●电话服务

●分布式应用开发

●通知与窗口管理

●多媒体技术

●安全技能

●任务管理

●WebGL

●国际化开发

●应用测试

●DFX面向未来设计

●鸿蒙系统移植和裁剪定制

……

《鸿蒙进阶实战》

●ArkTS实践

●UIAbility应用

●网络案例

……

获取以上完整鸿蒙HarmonyOS学习文档，请点击→纯血版全套鸿蒙HarmonyOS学习文档