Pagination Controller调用API问题：期望仅滚动至页面底部时触发

问题核心是PagingController的visibleThreshold参数配置不合理，默认值可能过大，导致还没滚动到页面底部就触发下一页请求。要实现仅滚动至页面底部时才调用分页API，只需调整以下几点：

1. 修正PagingController的visibleThreshold参数 #

在初始化pagingCtrl时，将visibleThreshold设置为1（或0），这个参数的含义是：当列表剩余未加载的item数量等于该值时，才触发下一页的API请求。

示例初始化代码：

// 对应你controller里的pagingCtrl初始化逻辑
final pagingCtrl = PagingController<int, dynamic>(
  firstPageKey: 0, // 第一页标识，通常从0或1开始
  visibleThreshold: 1, // 关键配置：仅当距离底部1个item时才触发加载
);

2. 确保分页请求逻辑仅在加载下一页时触发 #

确认你在监听pagingCtrl的加载请求时，只在pageRequestListener回调里调用API，避免在itemBuilder中额外触发请求。示例逻辑：

@override
void initState() {
  super.initState();
  controller.pagingCtrl.addPageRequestListener((pageKey) {
    // 仅在需要加载新页面时调用API
    _fetchNewsPage(pageKey);
  });
}

Future<void> _fetchNewsPage(int pageKey) async {
  try {
    final newsItems = await yourApiService.getNews(page: pageKey);
    final isLastPage = newsItems.length < yourPageSize; // 判断是否为最后一页
    if (isLastPage) {
      controller.pagingCtrl.appendLastPage(newsItems);
    } else {
      final nextPageKey = pageKey + 1;
      controller.pagingCtrl.appendPage(newsItems, nextPageKey);
    }
  } catch (err) {
    controller.pagingCtrl.error = err;
  }
}

3. 修正后的完整页面代码 #

结合你提供的原代码，调整后补充布局修复（PagedListView需用Expanded包裹避免布局错误）：

Scaffold( 
  body: Column(
    children: [
      Search(),
      Expanded(
        child: PagedListView<int, dynamic>(
          pagingController: controller.pagingCtrl,
          padding: EdgeInsets.only(bottom: 25.h),
          physics: const BouncingScrollPhysics(parent: AlwaysScrollableScrollPhysics()),
          builderDelegate: PagedChildBuilderDelegate<dynamic>(
            itemBuilder: (context, item, index) =>
                _buildNewsCard(title: item?.title),
            firstPageProgressIndicatorBuilder: (_) => _buildNewsCardSkeleton(6),
            newPageProgressIndicatorBuilder: (_) => _buildNewsCardSkeleton(6)
          )
        ),
      )
    ],
  )
)

调整完成后，初始化时只会加载第一页数据，后续只有当列表滚动到接近底部（距离底部1个item）时，才会触发下一页的API请求，完全符合需求。

内容的提问来源于stack exchange，提问作者Midlaj Nazar