spporan / flutteroverlayloader Goto Github PK

A new Flutter package for developer who want to show overlay loader or progress Indicator for completing future task.

License: Apache License 2.0

Java 1.06% Swift 2.77% Objective-C 0.25% Dart 95.92%

flutteroverlayloader's Introduction

flutter_overlay_loader

A simple Flutter package for managing loader when fetching remote data or any long running async task. Flutter overlay loader is easy to use. You can show loader using only write two lines of code.

Overlay loader without overlaying Appbar

Overlay Loader without overlaying BottomAppBar and also overlaying AppBar

Getting Started

Installing

dependencies:
  flutter_overlay_loader: ^1.0.8

Import

import 'package:flutter_overlay_loader/flutter_overlay_loader.dart';

How To Use

When start network call then call this line of code..

Loader.show(context,progressIndicator:LinearProgressIndicator());

After finished network call then call :

Loader.hide();

You can customize this loader..

Loader.show(context,
  isSafeAreaOverlay: false,
  isBottomBarOverlay: false,
  overlayFromBottom: 80,
  overlayColor: Colors.black26,
  progressIndicator: CircularProgressIndicator(backgroundColor: Colors.red),
  themeData: Theme.of(context)
    .copyWith(colorScheme: ColorScheme.fromSwatch().copyWith(secondary: Colors.green))
);

You can also check loader is showing or not using the property : Loader.isShown and you can prevent back pressed like this snippet:

WillPopScope(
  child: //TODO , 
  onWillPop:()async => !Loader.isShown
)

Finally dispose call hide method on dispose method :

@override
void dispose() {
  Loader.hide();

  super.dispose();
}

flutteroverlayloader's People

Contributors

Stargazers

Watchers

Forkers

richiemcmullen kevinyangyang alfiepoleon avomandjian auttapong gorgaborjozsef aramayyes kusayp segungreat ruaa-ali g33kfreak

flutteroverlayloader's Issues

Disable Android Back Button Activity while Loading is Shown

Hello,

Is there any way we can disable user interaction i.e. Android's notorious back button while the loader is being shown?

Thank you.

Cannot Show Overlay Loader

I cannot show Overlay Loader because of this exception:
I/flutter (10277): 'package:flutter/src/widgets/overlay.dart': Failed assertion: line 147 pos 12: '_overlay != null': is not true.
It is very simple case. I call Loader.show before network call but that exception failed. What did I miss?

Doctor summary (to see all details, run flutter doctor -v):
[√] Flutter (Channel stable, 2.5.3, on Microsoft Windows [Version 10.0.19042.1348], locale en-US)
[√] Android toolchain - develop for Android devices (Android SDK version 30.0.3)
[√] Chrome - develop for the web
[√] Android Studio (version 2020.3)
[√] VS Code (version 1.63.1)
[√] Connected device (3 available)

flutter_overlay_loader: ^1.0.3

How can I write test for the loader presence or loader hide?

Why SafeArea

Hi I use you lib in my app, but after investigate your code I see that you use into the overlay the SafeArea. Now if we need to cover all down widgets with a semi transparent overlay, why we need to skip the notch or bottom padding?

Need Text

I include the plugin to my code working fine. But when want to add text below the progress bar text comes with yellow underline.

NullSafety support

Could you please add support of NullSafety to this package?

Overlay Color Change

Hi,

Can we change the background color of the overlay itself and are there any other properties we have access to in regards to the overlay?

Sorry, I'm a flutter NoOB!

Regards

Null check operator used on a null value

Hi,
I got an error if I call Loader.show(context); then suddenly call Loader.hide();, It will show an error on debug console

thanks,

Bottom part of screen not covered by the overlay