Search packages, repositories and app categories

flutter_dropdown_alert cover
Package detailsv1.0.7

flutter_dropdown_alert

A dropdown alert package for flutter, help user notify the alert like push notification when call api success, fail or waring.

AndroidiOSWebmacOSWindowsLinux
30-day downloads
3.2K
Likes
99
Pub points
140

Install package

flutter pub add flutter_dropdown_alert

Package Overview

Package selection guidance compiled from public package information, community data, and project usage.

A Flutter package that provides a dropdown-style alert system to display notifications similar to push notifications. It enables developers to show success, failure, or warning messages after API calls, enhancing user feedback in a visually appealing and non-intrusive way. The alerts slide down from the top of the screen and can be customized with different styles and behaviors. Designed for cross-platform use, it supports Android, iOS, Web, macOS, Windows, and Linux.

Use cases

  • Displaying API call results
  • Showing user warnings
  • Notifying success or error states
  • Enhancing user feedback in forms
  • Providing real-time status updates

Key features

  • Slide-down notification animation
  • Customizable alert types
  • Cross-platform compatibility
  • Simple API integration
  • Configurable duration and position

Suitable for

  • Mobile and web apps needing visual feedback
  • Developers seeking lightweight toast alternatives
  • Apps requiring immediate user notifications
  • Projects with frequent API interactions
  • UX-focused applications

Considerations

  • Limited customization compared to full toast libraries
  • May require additional styling for complex designs
  • Not ideal for persistent notifications
  • Best suited for temporary alerts only
  • Depends on proper state management for timing

Original README

Original README snapshot from the linked source repository. Visit the repository for the latest content.

pub package

flutter_dropdown_alert

A dropdown alert package for flutter

Dropdown alert will help to notify to user when you call api success, error or something like that, such as in app notification. It's will similar with push notification but you can custom more than that. You can show alert at anywhere without widget.

Demo

Top:

Bottom:

How to use it.

# pubspec.yaml

dependencies:
  flutter:
    sdk: flutter
  flutter_dropdown_alert: <last-version>

Just create a Stack widget and add DropdownAlert() inside MaterialApp which should be in main.dart like this:

import 'package:flutter_dropdown_alert/dropdown_alert.dart';
 MaterialApp(
       title: 'Dropdown Alert Demo',
       theme: ThemeData(
         visualDensity: VisualDensity.adaptivePlatformDensity,
       ),
       builder: (context, child) => Stack(
         children: [
            child!,
            DropdownAlert()
         ],
       ),
       home: MyHomePage(title: 'Flutter Dropdown Alert Demo'),
     );

Full example source code:

https://github.com/vantuan88291/flutter_bloc_modular

Show alert anywhere, even inside bloc without widget:

Next, import 'alert_controller.dart' into your dart code

import 'package:flutter_dropdown_alert/alert_controller.dart';
   AlertController.show("Title", "message here!", TypeAlert.success, payload);

The payload param is Map<String, dynamic>, this param is optional, should use to give data into the alert and get it when click on alert.

Hide alert:

The alert will automatically hide, but if you use delayDismiss: 0, it will freeze and not auto hide, you have to hide the alert by this code:

   AlertController.hide();

Listener when click on alert:

There are 2 ways to do that:

  • Using listener of controller, put this code inside initState() of widget:
   AlertController.onTabListener((Map<String, dynamic>? payload, TypeAlert type) {
         print("$payload - $type");
       });
  • Using param onTap:
   DropdownAlert(onTap: (Map<String, dynamic> payload?, TypeAlert type) {
                print("$payload - $type");
             },)

TypeAlert

Type description
TypeAlert.success Type when action success, the background of alert will green
TypeAlert.warning Type when action warning, the background of alert will brown
TypeAlert.error Type when action error, the background of alert will red

parameters

parameter description default
onTap Callback when tab to alert, will give: Function(Map<String, dynamic>, TypeAlert) null
successImage Image.asset() of success alert, uri of assets image Icon widget
warningImage Image.asset() of warning alert, uri of assets image Icon widget
errorImage Image.asset() of error alert, uri of assets image Icon widget
closeImage Image.asset() of close image, when showCloseButton is true Icon widget
errorBackground Color of background when error Colors.red
successBackground Colors.green
warningBackground 0xFFCE863D
titleStyle TextStyle of title
contentStyle TextStyle of content
maxLinesTitle null
maxLinesContent null
duration duration of animation 300
delayDismiss delay time when alert auto dismiss, set to 0 if you want to freeze alert 3000
position show the position of alert, include: AlertPosition.TOP, AlertPosition.BOTTOM AlertPosition.TOP
showCloseButton When close button is present, only can click on button close to hide the alert false
avoidBottomInset Add optional variable for inset overlap false

The ideal from react-native-dropdownalert

Categories

Source repository

Projects using this package