refresh_paging_listview 1.3.1

包含支持下拉刷新，上拉加载更多组件。另外封装了简单的分页加载页面，ListView支持设置headers、footers和空页面

refresh_paging_listview

介绍

本库在pull_to_refresh_flutter3基础上增加分页加载、设置headers、footers和空页面功能。 刷新和加载更多部分参考flutter_pulltorefresh

Sample

用法

   dependencies:

     refresh_paging_listview: ^1.3.1

copied to clipboard

import package

  import 'package:refresh_paging_listview/refresh_paging_listview.dart';

copied to clipboard

分页部分 example：

   class TaskPage extends BaseRefreshList {
     const TaskPage({super.key});

     @override
     State<TaskPage> createState() => _TaskPageState();
   }

   class _TaskPageState extends BaseRefreshListState<TaskEntity, TaskPage> {
     @override
     Widget build(BuildContext context) {
       super.build(context);
       return buildRefreshList(
           enableLoadMore: false,
           emptyConfig: EmptyConfig(...),
           headers: [
             ListHeaderItem(),
           ],
           footers: [
             ListFooterItem(),
           ],
           child: ListView.builder(
               itemBuilder: itemBuilder,
               itemCount: itemCount,
           ),
         );
     }
     
     @override
     Widget buildListItem(BuildContext context, TaskEntity item, int index) {
       return ListTile(...);
     }
     
     @override
     Future<List<TaskEntity>> loadData(int page) async {
       return [data];
     }
   }

copied to clipboard

全局配置RefreshConfiguration

    // 全局配置子树下的SmartRefresher,下面列举几个特别重要的属性
     RefreshConfiguration(
         //分页接口初始页码
         initPage: 1,
         //空数据时的空页面
         emptyBuilder: (config) => EmptyView(config: config),
         emptyConfig: EmptyConfig(
           text: "暂无数据，请稍后再试！",
           image: "images/ic_empty.png",
         ),
         headerBuilder: () => WaterDropHeader(),        // 配置默认头部指示器,假如你每个页面的头部指示器都一样的话,你需要设置这个
         footerBuilder:  () => ClassicFooter(),        // 配置默认底部指示器
         headerTriggerDistance: 80.0,        // 头部触发刷新的越界距离
         springDescription:SpringDescription(stiffness: 170, damping: 16, mass: 1.9),         // 自定义回弹动画,三个属性值意义请查询flutter api
         maxOverScrollExtent :100, //头部最大可以拖动的范围,如果发生冲出视图范围区域,请设置这个属性
         maxUnderScrollExtent:0, // 底部最大可以拖动的范围
         enableScrollWhenRefreshCompleted: true, //这个属性不兼容PageView和TabBarView,如果你特别需要TabBarView左右滑动,你需要把它设置为true
         enableLoadingWhenFailed : true, //在加载失败的状态下,用户仍然可以通过手势上拉来触发加载更多
         hideFooterWhenNotFull: false, // Viewport不满一屏时,禁用上拉加载更多功能
         enableBallisticLoad: true, // 可以通过惯性滑动触发加载更多
        child: MaterialApp(
            ........
        )
    );

copied to clipboard