Skip to content
pubscout

flutter_chen_refresh

4.0.0, released 3 months ago by an unverified publisher

A Flutter refresh library for pull-down refresh and pull-up load with customizable indicators.

WASM-ready
$ flutter pub add flutter_chen_refresh
Source repository

What it does

Provides a SmartRefresher widget that wraps scroll components like ListView and GridView to support pull-down refresh, pull-up load, custom animations, and physics configurations. It includes multiple indicators like classic, water drop, and material styles.

AI-written summary of version 4.0.0, based on the package's README and metadata. Report an inaccuracy

Use it when

  • You need custom pull-to-refresh and load-more behaviors on scroll views.
  • You want advanced overscroll and spring physics customization.
  • You require global indicator configurations for your app's refresh components.

Skip it when

  • You are using a setup where the SmartRefresher cannot be the direct parent of the ScrollView.
  • You only need the built-in RefreshIndicator from Material.

Strengths

  • Supports almost all ScrollWidgets like ListView, GridView, and CustomScrollView.
  • Provides numerous built-in refresh styles, indicators, and two-level refresh effects.
  • Extensive global configuration options for physics, spring animations, and behaviors.

Weaknesses

  • Strict requirement that the ScrollView must be the direct child of SmartRefresher without nesting intermediates.
  • Can be incompatible with certain PageView and TabBarView configurations depending on settings.

Setup

Kind
Flutter widgets
Effort
Low
Code generation
No
Direct dependencies
0

Not documented

RefreshController _refreshController = RefreshController(initialRefresh: false);

SmartRefresher(
  enablePullDown: true,
  enablePullUp: true,
  controller: _refreshController,
  onRefresh: _onRefresh,
  onLoading: _onLoading,
  child: ListView.builder(
    itemBuilder: (c, i) => Card(child: Center(child: Text('Item $i'))),
    itemCount: 10,
  ),
)

Alternatives

Packages that do the same job and could replace flutter_chen_refresh.

Works with

Packages commonly used together with flutter_chen_refresh: ones it builds on, ones built on it, and its own family.