List如何实时获取可见的ListItem索引值
========================

#### 问题现象

滚动List组件，如何实时获取第一个可见的Item和最后一个可见的Item的索引位置？

#### 效果预览

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/f5/v3/WgABFLgjS_eBx2rYIur4Dg/zh-cn_image_0000002628613340.png?HW-CC-KV=V1&HW-CC-Date=20260709T133959Z&HW-CC-Expire=86400&HW-CC-Sign=F2042FB9769C736B88A51D0FEF1DBAF03F79DE36CAF2824F0921125EABCE2E00 "点击放大")

#### 背景知识

*   [List](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-container-list)：列表包含一系列相同宽度的列表项。适合连续、多行呈现同类数据，例如图片和文本。
*   [ListItem](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-container-listitem)：用来展示列表具体Item，必须配合List来使用。
*   [onAreaChange](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-universal-component-area-change-event#onareachange)在组件大小变化时触发，可用于获取组件的坐标和宽高。
*   List显示区域内第一个子组件的索引值或最后一个子组件的索引值有变化时会触发[onScrollIndex](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-container-list#onscrollindex)，列表滑动停止时触发[onScrollStop](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-container-list#onscrollstop)。

#### 解决方案

具体实现如下：

1.  使用onAreaChange获取List组件的宽高，用于后续判断Item是否在List区域内。
2.  列表初始化后需要先使用onScrollIndex获取第一个和最后一个Item，后续使用onScrollStop来获取首尾的Item。
3.  获取到的首尾Item后，判断其是否完全可见，首部Item不完全可见则取后一位，尾部Item不完全可见则取前一位。

@Entry
@Component
struct ListVisibleByH {
  private arr: number\[\] \= \[\];
  private scrollerForList: Scroller \= new Scroller();
  @State startStr: string \= '';
  startIndex \= 0; _// 保存第一个可见Item_
  endIndex \= 0; _// 保存最后一个可见Item_
  listHeight: number \= 0; _// 保存list的高度_

  private judgeVisibleByHeight() {
    console.info('judgeVisibleByHeight');
    this.startStr \= '';
   _ // 判断是否遮挡，判断条件可自行调节，这里设置3vp的误差_
    let rect \= this.scrollerForList.getItemRect(this.startIndex);
    if (rect.y < -3) {
      this.startIndex \= this.startIndex \+ 1; _// 上方元素y坐标小于\-3，被遮挡_
    }
    rect \= this.scrollerForList.getItemRect(this.endIndex);
    if (rect.y \+ rect.height \> this.listHeight \+ 3) {
      this.endIndex \= this.endIndex \- 1; _// 下方元素高度超过父组件的高度，被遮挡_
    }
    if (this.startIndex <\= this.endIndex) {
      this.startStr \= \`首尾可见Item：${this.startIndex}, ${this.endIndex}\`;
    } else {
      this.startStr \= '没有能全部显示的Item';
    }
  }

  aboutToAppear() {
    for (let i \= 0; i < 20; i++) {
      this.arr.push(i);
    }
  }

  build() {
    Flex({ direction: FlexDirection.Column }) {
      Text(this.startStr)
        .textAlign(TextAlign.Center)
        .height(50)
        .width('100%');
      Row() {
        List({ space: 20, initialIndex: 0, scroller: this.scrollerForList }) {
          ForEach(this.arr, (item: number) \=\> {
            ListItem() {
              Text(\`${item}\`)
                .width('100%').fontSize(16)
                .textAlign(TextAlign.Center);
            }
            .borderRadius(16).backgroundColor('#F1F3F5')
            .width('90%')
            .height(200);
          }, (item: number) \=\> item.toString());
        }
        .expandSafeArea(\[SafeAreaType.SYSTEM\], \[SafeAreaEdge.BOTTOM\])
        .alignListItem(ListItemAlign.Center)
        .listDirection(Axis.Vertical)
        .height('100%')
        .width('100%')
        .borderRadius(10)
        .onAreaChange((oldValue, newValue) \=\> {
          console.info(\`onAreaChange ${oldValue}\`);
          this.listHeight \= newValue.height as number; _// list的高度_
          this.judgeVisibleByHeight(); _// 初始判断_
        })
        .onScrollIndex((start, end) \=\> {
          this.startIndex \= start;
          this.endIndex \= end;
        })
        .onScrollStop(() \=\> {
        _  // 缓存开始结束索引：在最后一项继续滑动，不会触发onScrollIndex_
          let tmpStart \= this.startIndex;
          let tmpEnd \= this.endIndex;
          this.judgeVisibleByHeight();
          this.startIndex \= tmpStart;
          this.endIndex \= tmpEnd;
        });
      }.width('100%').height('100%');
    }.width('100%').height('100%');
  }
}

#### 常见FAQ

Q：在List组件中使用ListItemGroup的情况下，如何获取其中ListItem的索引值？

A：onScrollIndex回调将ListItemGroup作为一个整体占一个索引值，不计算ListItemGroup内部ListItem的索引值，因此就会获取不到当前ListItemGroup内ListItem的索引值。可以用[onVisibleAreaChange](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-universal-component-visible-area-change-event#onvisibleareachange)回调来监听ListItem的可见状态变化。

Q：怎么设置多个ListItemGroup同时出现时，只显示最顶部的header中的Button按钮？

A：通过给ListItemGroup组件添加onVisibleAreaChange事件中，判断当前显示了哪些ListItemGroup，同时选择其中最顶部的ListItemGroup显示Button。