tip_dialog 2.1.0

  • Readme
  • Changelog
  • Example
  • Installing
  • 84

TipDialog #

中文版

A Flutter Tip Dialog

Loading Type DialogSuccess Tye DialogFail Type Dialog
LoadingSuccessFail
Info Type DialogOnly Icon DialogOnl Text Dialog
InfoOnlyIconOnlyText
Custom Icon DialogCustom Body Dialog
CustomIconCustomBody

1. Depend on it #

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

dependencies:
  tip_dialog: ^2.1.0

2. Install it #

You can install packages from the command line: with Flutter:

$ flutter packages get

3. Import it #

Now in your Dart code, you can use:

import 'package:tip_dialog/tip_dialog.dart';

4. Use #

Available attributes #

/// [TipDialogContainer]
@required this.child,
/// automatically disappear time
this.duration: const Duration(seconds: 3),
/// mask layer alpha
this.maskAlpha: 0.3

Global Use (2.1.0) #

/// Use [TipDialogContainer] globally
/// This widget can be globally supported
void main() => runApp(new MyApp());
class MyApp extends StatelessWidget {
  // This widget is the root of your application.
  @override
  Widget build(BuildContext context) {
    return new TipDialogContainer(
        child: new MaterialApp(
          title: 'TipDialog Demo',
          theme: new ThemeData(),
          home: new MyHomePage(title: 'TipDialog Demo Home Page'),
        ));
  }
}
/// use TipDialogHelper to show tip
 Widget build(BuildContext context) {
    return new Scaffold(
      appBar: new AppBar(
        title: new Text(widget.title),
        elevation: 0.5,
      ),
      body: new ListView(children: <Widget>[
        _buildItem("Loading Type Tip Dialog", () async {
          TipDialogHelper.loading(context, "Loading");
          await new Future.delayed(new Duration(seconds: 5));
          TipDialogHelper.dismiss(context);
        }),
        new Divider(),
        _buildItem("Success Type Tip Dialog", () async {
          TipDialogHelper.success(context, "Loaded Successfully");
        }),
        new Divider(),
        _buildItem("Fail Type Tip Dialog", () async {
          TipDialogHelper.fail(context, "Load Failed");
        }),
        new Divider(),
        _buildItem("Info Type Tip Dialog", () async {
          TipDialogHelper.info(context, "Do Not Repeat");
        }),
        new Divider(),
        _buildItem("Only Icon Tip Dialog", () async {
          TipDialogHelper.show(context,
              tipDialog: new TipDialog(
                type: TipDialogType.SUCCESS,
              ));
        }),
        new Divider(),
        _buildItem("Only text Tip Dialog", () async {
          TipDialogHelper.show(context,
              tipDialog: new TipDialog(
                type: TipDialogType.NOTHING,
                tip: "Do Not Repeat",
              ));
        }),
        new Divider(),
        _buildItem("Custom Icon Tip Dialog", () async {
          TipDialogHelper.show(context,
              tipDialog: new TipDialog.customIcon(
                icon: new Icon(
                  Icons.file_download,
                  color: Colors.white,
                  size: 30.0,
                  textDirection: TextDirection.ltr,
                ),
                tip: "Download",
              ));
        }),
        new Divider(),
        _buildItem("Custom Body Tip Dialog", () async {
          TipDialogHelper.show(context,
              tipDialog: new TipDialog.builder(
                bodyBuilder: (context) {
                  return new Container(
                    width: 120.0,
                    height: 90.0,
                    alignment: Alignment.center,
                    child: new Text(
                      "Custom",
                      style: new TextStyle(color: Colors.white),

                      /// if TipDialogContainer are outside of MaterialApp,
                      /// here is a must to set
                      textDirection: TextDirection.ltr,
                    ),
                  );
                },
                color: Colors.blue.withAlpha(150),
              ));
        }),
        new Divider(),
      ])
    );
  }

Global Use (deprecated on 2.1.0) #

/// Use [TipDialogContainer] globally
/// This widget can be globally supported
void main() => runApp(new MyApp());
class MyApp extends StatelessWidget {
  // This widget is the root of your application.
  @override
  Widget build(BuildContext context) {
    return new TipDialogContainer(
        child: new MaterialApp(
          title: 'TipDialog Demo',
          theme: new ThemeData(),
          home: new MyHomePage(title: 'TipDialog Demo Home Page'),
        ));
  }
}

/// Use [TipDialogConnector] to obtain [TipDialogController]
Widget build(BuildContext context) {
    return new Scaffold(
      appBar: new AppBar(
        title: new Text(widget.title),
        elevation: 0.5,
      ),
      body: new TipDialogConnector(
        builder: (context, tipController) {
          return new ListView(children: <Widget>[
            _buildItem("Loading Type Tip Dialog", () async {
              tipController.show(
                  tipDialog: new TipDialog(type: TipDialogType.LOADING, tip: "Loading"),
                  isAutoDismiss: false);
              await new Future.delayed(new Duration(seconds: 3));
              tipController.dismiss();
            }),
            new Divider(),
            _buildItem("Success Type Tip Dialog", () async {
              tipController.show(
                  tipDialog: new TipDialog(
                    type: TipDialogType.SUCCESS,
                    tip: "Loaded Successfully",
                  ));
            }),
          ]);
        },
      )
    );
  }

Use a custom widget when using [TipDialogContainer] globally, there may be appear some unexpected errors. such as Text or Icon, will appear similar to the following error.

No Directionality widget found.

Just set TextDirection just fine. See the custom Widget in the example for details.

5. Default Dialog Type #

enum TipDialogType { NOTHING, LOADING, SUCCESS, FAIL, INFO }

NONTHING: no icon
LOADING: have a loading icon
SUCCESS: have a success icon
FAIL: have a fail icon
INFO: have a info icon

6. State And TipDialogController Method #

/// tipDialog: Need to display the widget
///
/// isAutoDismiss: decide whether to disappear automatically, default is true
/// if true, the dialog will not automatically disappear
/// otherwise, the dialog will automatically disappear after the [Duration] set by [TipDialogContainer]
void show({@required Widget tipDialog, bool isAutoDismiss: true});

/// dismiss dialog
void dismiss();

See the example directory for more details.

7. Change log #

[2.1.0]

  • add TipDialogHelper and deprecated TipDialogConnector

[2.0.1]

  • fix dismiss bug
  • upgrade android build gradle to 5.1.1

[2.0.0]

  • set default auto dismiss duration as 2 seconds
  • delete [TipDialogContainer] Partial parameters -- show -- outSideTouchable -- defaultTip -- defaultType
  • change show method parameter isLoading to isAutoDismiss
  • force display mask layer

[1.1.2] - (MODIFY)

  • fix infinite call dismiss bug
  • fixed an issue where setting the isLoading value is invalid

[1.1.1] - (MODIFY)

  • fix bugs that occur when using globally

[1.1.0] - (FUNCTION CHANGE)

  • add tip dialog global support

[1.0.1] - (MODIFY).

  • fix loading view version bug.
  • set default loading duration

[1.0.0] - first release.

  • add release.

[1.0.0] - first release.

  • add release.

[1.0.1] - (MODIFY).

  • fix loading view version bug.
  • set default loading duration

[1.1.0] - (FUNCTION CHANGE)

  • add tip dialog global support

[1.1.1] - (MODIFY)

  • fix bugs that occur when using globally

[1.1.2] - (MODIFY)

  • fix infinite call dismiss bug
  • fixed an issue where setting the isLoading value is invalid

[2.0.0]

  • set default dismiss duration as 2 seconds
  • delete TipDialogContainer parameters -- show -- outSideTouchable -- defaultTip -- defaultType
  • change show method parameter isLoading to isAutoDismiss
  • force display mask layer

[2.0.1]

  • fix dismiss bug
  • upgrade android build gradle to 5.1.1

[2.1.0]

  • add TipDialogHelper and deprecated TipDialogConnector

example/README.md

example #

A new Flutter application.

Getting Started #

For help getting started with Flutter, view our online documentation.

Use this package as a library

1. Depend on it

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


dependencies:
  tip_dialog: ^2.1.0

2. Install it

You can install packages from the command line:

with Flutter:


$ flutter pub get

Alternatively, your editor might support flutter pub get. Check the docs for your editor to learn more.

3. Import it

Now in your Dart code, you can use:


import 'package:tip_dialog/tip_dialog.dart';
  
Popularity:
Describes how popular the package is relative to other packages. [more]
77
Health:
Code health derived from static analysis. [more]
100
Maintenance:
Reflects how tidy and up-to-date the package is. [more]
80
Overall:
Weighted score of the above. [more]
84
Learn more about scoring.

We analyzed this package on Dec 10, 2019, and provided a score, details, and suggestions below. Analysis was completed with status completed using:

  • Dart: 2.7.0
  • pana: 0.13.1+4
  • Flutter: 1.12.13+hotfix.4

Health suggestions

Fix lib/tip_dialog.dart. (-0.50 points)

Analysis of lib/tip_dialog.dart reported 1 hint:

line 311 col 17: 'inheritFromWidgetOfExactType' is deprecated and shouldn't be used. Use dependOnInheritedWidgetOfExactType instead. This feature was deprecated after v1.12.1..

Maintenance suggestions

The package description is too short. (-20 points)

Add more detail to the description field of pubspec.yaml. Use 60 to 180 characters to describe the package, what it does, and its target use case.

Dependencies

Package Constraint Resolved Available
Direct dependencies
Dart SDK >=2.0.0-dev.28.0 <3.0.0
flutter 0.0.0
loading_view ^1.0.2 1.0.2
Transitive dependencies
collection 1.14.11 1.14.12
meta 1.1.8
sky_engine 0.0.99
typed_data 1.1.6
vector_math 2.0.8
Dev dependencies
flutter_test