flutter_refresh_indicator 1.2.0

This package provides a refresh indicator widget that is far more flexible and native-like than the default Flutter one, built on top of flutter_appbar.

Introduction

This package provides a refresh indicator widget that is far more flexible and native-like than the default Flutter one, built on top of flutter_appbar.

Preview

The gif image below may appear distorted and choppy due to compression.

Usage

The following explains the basic usage of this package.

When Context

import 'package:flutter/material.dart' hide RefreshIndicator;

// Other Alias: PullToRefresh and SwipeToRefresh
RefreshIndicator(
    onRefresh: ..., // AsyncCallback
    child: ...
),

When Android

This widget for ClampingScrollPhysics.

ClampingRefreshIndicator(
    onRefresh: ..., // AsyncCallback
    child: ...
),

When IOS

This widget for BouncingScrollPhysics.

BouncingRefreshIndicator(
    onRefresh: ..., // AsyncCallback
    child: ...
),

How to define the style globally.

Using Material Theme

This is the traditional way to define themes in Flutter.

MaterialApp(
    theme: ThemeData(
        progressIndicatorTheme: ProgressIndicatorThemeData(
            color: ..., // foregroundColor
            refreshBackgroundColor: ... // backgroundColor
        )
    ),
);

Using PrimaryRefreshIndicator widget

PrimaryRefreshIndicator defines the refresh indicator style for its descendant widgets, similar to how PrimaryScrollController provides a scroll controller to its descendants.

PrimaryRefreshIndicator(
    clampingIndicatorBuilder: (...), // Custom indicator for Clamping
    bouncingIndicatorBuilder: (...), // Custom indicator for Bouncing
)