搜索插件、代码仓与 APP 分类

refresh_loadmore 封面
插件详情v2.0.7

refresh_loadmore

一个支持下拉刷新和上拉加载更多数据的 Flutter 组件

AndroidiOSWebmacOSWindowsLinux
近 30 天下载
143
喜欢数
27
Pub 分数
160

安装插件

flutter pub add refresh_loadmore

插件介绍

基于插件公开信息、社区数据与项目使用情况整理的选型参考。

一个 Flutter 包,为列表提供下拉刷新和上拉加载更多功能,增强可滚动内容中的用户交互体验。它支持跨所有主要平台(包括 Android、iOS、Web、macOS、Windows 和 Linux)的平滑动画以及可自定义的刷新/加载状态。非常适合实现动态数据流,例如新闻、社交媒体时间线或产品列表。该组件轻量且可无缝集成到 ListView 及其他可滚动小部件中。

适合场景

  • 动态列表更新
  • 社交媒体动态加载
  • 电子商务产品分页
  • 实时数据同步
  • 无限滚动界面

主要特点

  • 下拉刷新手势
  • 上拉加载更多手势
  • 可自定义的刷新指示器
  • 跨平台兼容性
  • 平滑的动画过渡
  • 可配置的加载状态

适合对象

  • 开发数据密集型应用的开发者
  • 需要无限滚动的应用程序
  • 需要一致的UI模式的团队
  • 针对多个平台的项目
  • 希望代码量最少的用户

使用建议

  • 需要与可滚动控件集成
  • 复杂的 UI 可能需要自定义样式
  • 性能取决于数据源的效率
  • 不适用于静态内容
  • 有限的内置错误处理

原始 README

以下为关联源码仓库的 README 原文快照,最新内容请访问源码仓库。

refresh_loadmore

A Flutter component that supports pull-down refresh and pull-up to load more data (一个组件,支持下拉刷新,上拉加载更多数据).

Getting Started

Add this line to pubspec.yaml ( 添加这一行到pubspec.yaml)

dependencies:
     refresh_loadmore: ^2.0.7

How To Use

Use the class RefreshLoadmore

Properties and functions:

  /// Callback function on pull down to refresh | 下拉刷新时的回调函数
  final Future<void> Function()? onRefresh;

  /// Callback function on pull up to load more data | 上拉以加载更多数据的回调函数
  final Future<void> Function()? onLoadmore;

  /// Whether it is the last page, if it is true, you can not load more | 是否为最后一页,如果为true,则无法加载更多
  final bool isLastPage;

  /// Child widget | 子组件
  final Widget child;

  /// Prompt text widget when there is no more data at the bottom | 底部没有更多数据时的提示文字组件
  final Widget? noMoreWidget;

  /// Prompt widget when loading new data at the bottom | 正在加载数据时的提示组件
  final Widget? loadingWidget;

  /// Prompt padding for body if needed | 你可以自定义padding
  final EdgeInsetsGeometry? padding;

  /// You can use your custom scrollController, or not | 你可以使用自定义的 ScrollController,或者不使用
  final ScrollController? scrollController;

Examples

import 'package:flutter/material.dart';
import 'package:refresh_loadmore/refresh_loadmore.dart';

void main() {
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Demo',
      theme: ThemeData(
        primarySwatch: Colors.purple,
        visualDensity: VisualDensity.adaptivePlatformDensity,
      ),
      home: MyHomePage(title: 'Flutter Demo Home Page'),
    );
  }
}

class MyHomePage extends StatefulWidget {
  MyHomePage({Key? key, required this.title}) : super(key: key);

  final String title;

  @override
  _MyHomePageState createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  /// is the last page | 是否为最后一页
  bool isLastPage = false;

  List? list;
  int page = 1;

  @override
  void initState() {
    super.initState();
    loadFirstData();
  }

  Future<void> loadFirstData() async {
    await Future.delayed(Duration(seconds: 1), () {
      setState(() {
        list = [
          'dddd',
          'sdfasfa',
          'sdfgaf',
          'adsgafg',
          'dddd',
          'sdfasfa',
          'sdfgaf',
          'adsgafg',
          'dddd',
          'sdfasfa',
          'sdfgaf',
          'adsgafg'
              'adsgafg',
          'dddd',
          'sdfasfa',
          'sdfgaf',
          'adsgafg'
        ];
        isLastPage = false;
        page = 1;
      });
    });
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text(widget.title),
      ),
      body: list != null
          ? RefreshLoadmore(
              onRefresh: loadFirstData,
              onLoadmore: () async {
                await Future.delayed(Duration(seconds: 1), () {
                  setState(() {
                    list!.addAll(['123', '234', '457']);
                    page++;
                  });
                  print(page);
                  if (page >= 3) {
                    setState(() {
                      isLastPage = true;
                    });
                  }
                });
              },
              noMoreWidget: Text(
                'No more data, you are at the end',
                style: TextStyle(
                  fontSize: 18,
                  color: Theme.of(context).disabledColor,
                ),
              ),
              isLastPage: isLastPage,
              child: list!.isNotEmpty
                  ? Column(
                      children: list!
                          .map(
                            (e) => ListTile(
                              title: Text(e),
                              trailing: Icon(Icons.accessibility_new),
                            ),
                          )
                          .toList(),
                    )
                  : Center(
                      child: Text('empty'),
                    ),
            )
          : Center(child: CircularProgressIndicator()),
    );
  }
}



Renderings

images images images

所属分类

依赖

依赖清单 1 项

源码仓库

使用此插件的项目

暂无相关数据。