progress_dialog

A light weight package to show progress dialog. As it is a stateful widget, you can change the text shown on the dialog dynamically.

Supported Dart Versions

Dart SDK version >= 2.7.0

Demo

Installation

Add the Package

dependencies:
  progress_dialog: ^1.2.4

How to use

Import the package in your dart file

import 'package:progress_dialog/progress_dialog.dart';

Create and initialise a ProgressDialog object inside the build() method passing context to it

1. Initialize the ProgressDialog object
   

   final ProgressDialog pr = ProgressDialog(context);

2. By default it is a normal dialog to show some message, if you would like to use it to show percentage of progress done, specify the optional type parameter and specify if you want your dialog to dismiss when back button is pressed isDismissible parameter (Optional)
   

   //For normal dialog
   pr = ProgressDialog(context,type: ProgressDialogType.Normal, isDismissible: true/false, showLogs: true/false);
       
   //For showing progress percentage
   pr =  ProgressDialog(context,type: ProgressDialogType.Download, isDismissible: true/false, showLogs: true/false);

> Note: Please initialize the ```ProgressDialog```, where you have availability of the context
3. Style the progress dialog (Optional)
   

   pr.style(
     message: 'Downloading file...',
     borderRadius: 10.0,
     backgroundColor: Colors.white,
     progressWidget: CircularProgressIndicator(),
     elevation: 10.0,
     insetAnimCurve: Curves.easeInOut,
     progress: 0.0,
     textDirection: TextDirection.rtl,
     maxProgress: 100.0,
     progressTextStyle: TextStyle(
        color: Colors.black, fontSize: 13.0, fontWeight: FontWeight.w400),
     messageTextStyle: TextStyle(
        color: Colors.black, fontSize: 19.0, fontWeight: FontWeight.w600)
     );

   Note: You don't need to use all parameters, all of them are optional
   

4. Showing the progress dialog
   

   await pr.show();

5. Dynamically update the content shown out there
   

   pr.update(
     progress: 50.0,
     message: "Please wait...",
     progressWidget: Container(
       padding: EdgeInsets.all(8.0), child: CircularProgressIndicator()),
     maxProgress: 100.0,
     progressTextStyle: TextStyle(
       color: Colors.black, fontSize: 13.0, fontWeight: FontWeight.w400),
     messageTextStyle: TextStyle(
       color: Colors.black, fontSize: 19.0, fontWeight: FontWeight.w600),
     );

   Note: You don't need to use all parameters, all of them are optional
   

6. Dismissing the progress dialog
   

   pr.hide().then((isHidden) {
     print(isHidden);
   });
   
   // or
   await pr.hide();

Navigating to next screens must be done after the completion of Future - hide(). See here for example

Check if progress dialog is showing

bool isProgressDialogShowing = pr.isShowing();
print(isProgressDialogShowing);

Use custom body

    pr = ProgressDialog(
      context,
      type: ProgressDialogType.Normal,
      isDismissible: true,
      /// your body here
      customBody: LinearProgressIndicator(
        valueColor: AlwaysStoppedAnimation<Color>(Colors.blueAccent),
        backgroundColor: Colors.white,
      ),
    );

Demo

Default configuration/styles

If you don't like to configure/style the dialog and continue with the default style, it's okay but just have a look at our default configuration.

Well let's discuss limits for configuring it

Want to contribute?

Pull requests and issues are always welcome!

How to contribute?

1. Fork the repository
2. Clone it to your local machine
3. Open the project in your favourite editor
4. Open cmd/terminal and run flutter clean and then flutter packages get
5. Make the changes
6. Create a Pull Request

View the issues here

This library is only tested for Android, iOS contributors are most welcome

Loading indicator -> https://loading.io/