Buscar pacotes, repositórios e categorias de apps

Capa de liquid_pull_to_refresh
Detalhes do pacotev3.0.1

liquid_pull_to_refresh

Um indicador de atualização bonito e personalizável com algumas animações e transições legais para o flutter.

AndroidiOSWebmacOSWindowsLinux
Downloads em 30 dias
25,5 mil
Curtidas
826
Pontos Pub
150

Instalar pacote

flutter pub add liquid_pull_to_refresh

Visão geral do pacote

Orientação gerada a partir de informações públicas. Apenas para referência.

LiquidPullToRefresh é um pacote Flutter visualmente atraente que aprimora a funcionalidade padrão de puxar para atualizar com animações suaves e transições fluidas. Ele fornece um indicador de atualização moderno e semelhante a líquido que responde dinamicamente aos gestos do usuário, oferecendo uma experiência envolvente em todas as plataformas. Ideal para aplicativos que buscam um mecanismo de atualização refinado e interativo com configuração mínima. O pacote suporta Android, iOS, Web, macOS, Windows e Linux, tornando-o altamente versátil. Seu design personalizável permite que os desenvolvedores ajustem a aparência e o comportamento para combinar com a estética do aplicativo.

Casos de uso

  • Melhorando visualizações de lista com indicadores animados de atualização
  • Criando experiências imersivas em aplicativos móveis e web
  • Adicionando feedback dinâmico aos estados de carregamento de dados
  • Melhorando o acabamento da interface em aplicativos com grande volume de conteúdo
  • Implementando interações baseadas em gestos com estilo visual

Principais recursos

  • Efeitos de animação suave e líquida
  • Aparência personalizável do indicador de atualização
  • Compatibilidade multiplataforma
  • Integração fácil com ListView e outros widgets roláveis
  • Suporta tanto o pull-to-refresh quanto gatilhos de atualização manual
  • Duração e amortecimento de animação configuráveis

Indicado para

  • Desenvolvedores procurando melhorias modernas na interface
  • Aplicativos com atualizações frequentes de dados
  • Projetos do Flutter com foco em design
  • Interfaces de lista ou feed interativas
  • Equipes que priorizam o envolvimento do usuário e o feedback

Considerações

  • Pode afetar o desempenho em dispositivos de baixa potência devido às animações
  • Requer ajuste cuidadoso dos parâmetros de animação para uma experiência do usuário ideal
  • Opções limitadas de personalização em comparação com soluções totalmente personalizadas
  • Não ideal para necessidades simples de atualização minimalista
  • Conflitos potenciais com outras física de rolagem ou indicadores personalizados

README original

Snapshot do README original do repositório-fonte vinculado. Consulte o repositório para o conteúdo mais recente.

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.

Categorias

Repositório-fonte

Projetos que usam este pacote