ecp_paging

ecp_paging是一个分页组件库，整合下拉刷新 & 上拉加载，自动管理分页的组件

使用方式

添加依赖

ecp_paging: ^<版本号>

简单使用


 Paging(
        controller: controller, ///分页控制器
        task: () => testTask(), ///异步请求数据源
        child: GridView.builder(
          itemBuilder: (context, index) => Padding(
            padding: const EdgeInsets.all(12),
            child: Center(
              child: Text("${controller.getItem(index)} $index"),
            ),
          ),
          itemCount: controller.list.length,
          gridDelegate: const SliverGridDelegateWithMaxCrossAxisExtent(
              maxCrossAxisExtent: 120),
        ),
      )
    
    ...
    
    ///模拟数据源异步获取数据
    Future<List<String>?> testTask() async {
    await Future.delayed(const Duration(seconds: 2));
    if (controller.currentPageIndex == 3) {
      return [];
    }
    return List.filled(10, "position");
  }

功能说明

Paging 属性

  • child：需要分页的列表组件，一般为ListView或者GridView
  • task：异步分页数据请求，一般为接口
  • controller：分页组件控制器
  • header：下拉刷新头部组件（详见：EasyRefresh）
  • footer：加载更多尾部组件（详见：EasyRefresh）
  • initStatus：初始缺省状态，例如Loading,Error,Empty
  • autoRefresh：控制是否组件执行initState时执行刷新
  • enableRefresh：开启下拉刷新
  • enableLoadMore：开启上拉加载
  • factory：默认缺省页

PagingController 说明

  • firstPageIndex：起始分页页数
  • currentPageIndex：当前分页页数
  • list：当前分页数据模型列表
  • listNotify：当前分页数据模型列表通知
  • listNotify：当前分页数据模型列表通知
  • listNotify：当前分页数据模型列表通知
  • refresh：刷新方法，cleanList设置为true刷新时，会清除当前列表数据并显示PagingStatus.loading对应的缺省页，silence设置为true时，不会显示下拉刷新头，防止列表滑动至顶部；若设置了cleanList为true，则silence无效
  • loadMore：上拉加载方法
  • refreshList：手动刷新列表
  • addList：手动增加列表项
  • getItem：获取对应位置的数据

此库专为内部项目需求设计，若不符合您的使用场景，敬请谅解。

Libraries

ecp_paging