OpenHarmony ListView怎样刷新

在 OpenHarmony（ArkUI） 里，“ListView 刷新”通常指 数据变化后让列表重新渲染。不同开发方式（eTag / ArkTS）略有区别，下面按最常见场景说明。

一、ArkTS（声明式开发，推荐 ✅）

在 ArkTS 中，ListView 一般用 List + ForEach，刷新本质是状态驱动 UI。

1️⃣ 使用 @State 触发刷新（最常用）

@Entry
@Component
struct ListViewPage {
  @State listData: string[] = ['A', 'B', 'C']

  build() {
    Column() {
      Button('刷新数据')
        .onClick(() => {
          // 修改数据源即可刷新
          this.listData = ['A', 'B', 'C', 'D', 'E']
        })

      List() {
        ForEach(this.listData, (item: string) => {
          ListItem() {
            Text(item)
          }
        }, (item: string) => item)
      }
    }
  }
}

✅ 关键点

• 必须改 @State 变量
• 不能直接 listData.push()（不会触发刷新）
• 正确方式：

  this.listData = [...this.listData, 'new']
  

2️⃣ 下拉刷新（Refresh 容器）

@Entry
@Component
struct RefreshList {
  @State listData: string[] = ['1', '2', '3']
  @State isRefreshing: boolean = false

  build() {
    Refresh({ refreshing: this.isRefreshing }) {
      List() {
        ForEach(this.listData, item => {
          ListItem() {
            Text(item)
          }
        })
      }
    }
    .onRefreshing(() => {
      // 模拟网络请求
      setTimeout(() => {
        this.listData = ['new1', 'new2', 'new3']
        this.isRefreshing = false
      }, 1000)
    })
  }
}

3️⃣ 局部刷新（提升性能）

如果只改某一项：

this.listData[index] = newValue
this.listData = [...this.listData]

或使用 @Observed + @ObjectLink（对象数组场景）

二、JS（类 Web 开发，兼容旧版本）

如果是 FA 模型（JavaScript）：

this.listData = newData
this.$forceUpdate()

或：

this.listData.splice(0)
this.listData.push(...newData)

三、常见坑 ⚠️

❌ 直接修改数组不刷新
✅ 必须重新赋值

❌ key 不唯一
✅ ForEach 第三个参数必须唯一

四、总结

如果你用的是 具体版本（如 OpenHarmony 3.2 / 4.0） 或 JS / ArkTS，可以告诉我，我给你更精准示例。