如何获取ListView内当前处于可见状态的Widget（不可用scroll_to_widget包）

以下三种方案均不需要引入scroll_to_widget或其他外部依赖，可根据你的列表场景选择：

方案1：GlobalKey遍历校验（适合子项数量≤50的中小规模列表） #

给每个列表子项绑定唯一GlobalKey，监听滚动事件时逐个校验子项是否在可见视口内：

• 实现步骤：
  • 初始化与子项数量匹配的GlobalKey列表
  • 将GlobalKey赋值给每个itemBuilder返回的子Widget根节点
  • 滚动监听触发时遍历Key列表，通过RenderBox计算子项的全局位置判断可见性
• 核心代码片段：

final ScrollController _scrollController = ScrollController();
final List<GlobalKey> _itemKeys = List.generate(yourItemCount, (index) => GlobalKey());

// 绑定到ListView
ListView(
  controller: _scrollController,
  children: List.generate(yourItemCount, (index) => SizedBox(key: _itemKeys[index], child: yourChildWidget)),
)

// 滚动监听逻辑
_scrollController.addListener(() {
  final double screenHeight = MediaQuery.of(context).size.height;
  final List<Widget> visibleChildren = [];
  for (final key in _itemKeys) {
    if (key.currentContext == null) continue;
    final RenderBox renderBox = key.currentContext!.findRenderObject() as RenderBox;
    final Offset widgetTop = renderBox.localToGlobal(Offset.zero);
    final double widgetBottom = widgetTop.dy + renderBox.size.height;
    // 只要子项有任意部分出现在视口内就算可见，可根据需求调整边界阈值
    if (widgetBottom > 0 && widgetTop.dy < screenHeight) {
      visibleChildren.add(key.currentWidget!);
    }
  }
  // 这里处理得到的可见Widget列表
});

方案2：构建回调记录法（适合动态构建的中等规模列表） #

利用Flutter列表懒加载的特性，在itemBuilder触发时记录当前正在构建的子项索引，滚动结束后过滤有效可见范围：

• 实现逻辑：
  • 维护一个Set存储当前已构建的子项索引
  • itemBuilder每次被调用时将对应索引加入Set
  • 监听滚动结束事件，对已构建的索引做一次简单的位置校验，剔除预加载的不可见项
• 优势：不需要提前创建大量GlobalKey，内存占用更低

方案3：RenderSliver直接查询（性能最优，适合大规模/无限滚动列表） #

直接访问ListView底层的RenderSliverList对象，直接获取当前可见子项的索引范围，不需要遍历所有子项：

• 核心代码片段：

// 给ListView根节点绑定Key
final GlobalKey _listViewKey = GlobalKey();

ListView(
  key: _listViewKey,
  // 其他配置
)

// 滚动时获取可见范围
void getVisibleChildren() {
  final RenderObject? listRender = _listViewKey.currentContext?.findRenderObject();
  if (listRender is RenderSliverList) {
    final int firstIdx = listRender.childManager!.firstChildIndex;
    final int lastIdx = listRender.childManager!.lastChildIndex;
    // 直接从你的子Widget列表/数据源中截取firstIdx到lastIdx范围即可
    final List<Widget> visibleChildren = yourChildWidgetList.sublist(firstIdx, lastIdx + 1);
  }
}

注意：如果使用的是SliverGrid，将RenderSliverList替换为RenderSliverGrid即可，逻辑完全一致。如果需要排除仅露出极小部分的边缘子项，可以对首/尾索引对应的子项再做一次位置校验。

内容的提问来源于stack exchange，提问作者Markus Handel