パッケージ、リポジトリ、アプリカテゴリを検索

liquid_pull_to_refresh のカバー
パッケージ詳細v3.0.1

liquid_pull_to_refresh

Flutter用の美しいカスタムリフレッシュインジケータで、クールなアニメーションとトランジションを備えています。

AndroidiOSWebmacOSWindowsLinux
30日間ダウンロード
2.6万
いいね数
826
Pub ポイント
150

パッケージをインストール

flutter pub add liquid_pull_to_refresh

パッケージ概要

公開情報に基づく選定ガイドです。参考としてご利用ください。

LiquidPullToRefresh は、滑らかなアニメーションと流れるようなトランジションで標準的なプルツーリフレッシュ機能を強化する視覚的に魅力的な Flutter パッケージです。ユーザーのジェスチャーに応じてダイナミックに反応するモダンな液体のようなリフレッシュインジケーターを提供し、すべてのプラットフォームで没入感のあるユーザーエクスペリエンスを実現します。最小限のセットアップで洗練されたインタラクティブなリフレッシュメカニズムを求めるアプリに最適です。このパッケージは Android、iOS、Web、macOS、Windows、Linux をサポートしており、非常に汎用性が高いです。カスタマイズ可能なデザインにより、開発者はアプリの美学に合わせて外観や挙動を調整できます。

用途

  • アニメーション付きのリフレッシュインジケーターでリストビューを強化する
  • モバイルおよびウェブアプリでの没入型ユーザー体験の構築
  • データ読み込み状態に動的フィードバックを追加する
  • コンテンツが多く含まれるアプリケーションにおけるUIの仕上げの向上
  • 視覚的な魅力を備えたジェスチャーに基づくインタラクションの実装

主な機能

  • 滑らかな液体のようなアニメーション効果
  • カスタマイズ可能なリフレッシュインジケータの外観
  • クロスプラットフォーム互換性
  • ListView およびその他のスクロール可能なウィジェットとの簡単な統合
  • プルツーリフレッシュと手動リフレッシュの両方をサポートしています
  • アニメーションの持続時間とイージングをカスタマイズ可能

適している対象

  • 現代的なUIの向上を求める開発者
  • 頻繁にデータが更新されるアプリ
  • デザイン重視のFlutterプロジェクト
  • インタラクティブなリストまたはフィードインターフェース
  • ユーザーのエンゲージメントとフィードバックを重視するチーム

注意事項

  • アニメーションのため、低スペックデバイスでのパフォーマンスに影響する可能性があります
  • 最適なUXを得るためには、アニメーションパラメータの慎重な調整が必要です
  • 完全カスタムソリューションと比較して、カスタマイズオプションが限られている
  • シンプルでミニマリストな更新ニーズには理想的ではありません
  • 他のスクロール物理またはカスタムインジケーターとの潜在的な競合

元の README

関連するソースリポジトリの README 原文のスナップショットです。最新の内容はリポジトリをご覧ください。

Liquid Pull To Refresh

A beautiful and custom refresh indicator for flutter highly inspired from Ramotion Pull Down to Refresh. Try out our live example app.



Table of contents

Installing

1. Depend on it

Add this to your package's pubspec.yaml file:

dependencies:
  liquid_pull_to_refresh: ^3.0.1
2. Install it

You can install packages from the command line:

with pub:

$ pub get

with Flutter:

$ flutter packages get
3. Import it

Now in your Dart code, you can use:

import 'package:liquid_pull_to_refresh/liquid_pull_to_refresh.dart';

Usage

For adding this custom refresh indicator in your flutter app, you have to simply wrap ListView or GridView inside LiquidPullToRefresh. Also you have provide the value of onRefresh parameter which is a refresh callback.

Note - LiquidPullToRefresh can only be used with a vertical scroll view.

For example:

LiquidPullToRefresh(
        key: _refreshIndicatorKey,	// key if you want to add
        onRefresh: _handleRefresh,	// refresh callback
        child: ListView(),		// scroll view
      );

If you do not want the opacity transition of child then set showChildOpacityTransition: false. Preview regarding the both form of this widget is follows :-

showChildOpacityTransition: true showChildOpacityTransition: false

Documentation

LiquidPullToRefresh Class
Dart attribute Datatype Description Default Value
child ScrollView The widget below this widget in the tree. @required
onRefresh RefreshCallback A function that's called when the refreshing of page takes place. @required
height double The distance from the child's top or bottom edge to where the box will settle after the spring effect. 100.0
springAnimationDurationInMilliseconds int Duration in milliseconds of springy effect that occurs when we leave dragging after full drag. 1000
borderWidth double Border width of progressing circle in Progressing Indicator. 2.0
showChildOpacityTransition bool Whether to show child opacity transition or not. true
color Color The progress indicator's foreground color. ColorScheme.secondary
backgroundColor Color The progress indicator's background color. ThemeData.canvasColor
animSpeedFactor double Controls the speed of the animation after refresh. Used to fasten the ending animation. 1.0

For help on editing package code, view the flutter documentation.

Bugs or Requests

If you encounter any problems feel free to open an issue. If you feel the library is missing a feature, please raise a ticket on GitHub and I'll look into it. Pull request are also welcome.

See Contributing.md.

Donate

If you found this project helpful or you learned something from the source code and want to thank me, consider buying me a cup of :coffee:

Contributors

Thanks goes to these wonderful people (emoji key):


opannapo

💻

Anthony Taormina

📖

Erzhan

⚠️

Puttipong Wongrak

🐛

Aayush Malhotra

🐛

benja8151

📦 🚧

Remco Schrijver

📦 🚧

This project follows the all-contributors specification. Contributions of any kind welcome! See Contributing.md.

License

Liquid-Pull-To-Refresh is licensed under MIT license. View license.

カテゴリー

ソースリポジトリ

このパッケージを使用しているプロジェクト