Flushbar<T> class
A highly customizable widget so you can notify your user when you fell like he needs a beautiful explanation.
- Inheritance
-
- Object
- DiagnosticableTree
- Widget
- StatefulWidget
- Flushbar
Constructors
-
Flushbar({Key? key, String? title, Color? titleColor, double? titleSize, String? message, double? messageSize, Color? messageColor, Widget? titleText, Widget? messageText, Widget? icon, bool shouldIconPulse = true, double? maxWidth, EdgeInsets margin = const EdgeInsets.all(0.0), EdgeInsets padding = const EdgeInsets.all(16), BorderRadius? borderRadius, TextDirection textDirection = TextDirection.ltr, Color? borderColor, double borderWidth = 1.0, Color backgroundColor = const Color(0xFF303030), Color? leftBarIndicatorColor, List<
BoxShadow> ? boxShadows, Gradient? backgroundGradient, Widget? mainButton, OnTap? onTap, Duration? duration, bool isDismissible = true, FlushbarDismissDirection dismissDirection = FlushbarDismissDirection.VERTICAL, bool showProgressIndicator = false, AnimationController? progressIndicatorController, Color? progressIndicatorBackgroundColor, Animation<Color> ? progressIndicatorValueColor, FlushbarPosition flushbarPosition = FlushbarPosition.BOTTOM, double positionOffset = 0.0, FlushbarStyle flushbarStyle = FlushbarStyle.FLOATING, Curve forwardAnimationCurve = Curves.easeOutCirc, Curve reverseAnimationCurve = Curves.easeOutCirc, Duration animationDuration = const Duration(seconds: 1), FlushbarStatusCallback? onStatusChanged, double barBlur = 0.0, bool blockBackgroundInteraction = false, double? routeBlur, Color? routeColor, Form? userInputForm, Offset? endOffset, FlushbarRoute<T?> ? flushbarRoute})
Properties
- animationDuration → Duration
-
Use it to speed up or slow down the animation duration
final
- backgroundColor → Color
-
Will be ignored if backgroundGradient is not null
final
- backgroundGradient → Gradient?
-
Makes backgroundColor be ignored.
final
- barBlur → double
-
Default is 0.0. If different than 0.0, blurs only Flushbar's background.
To take effect, make sure your backgroundColor has some opacity.
The greater the value, the greater the blur.
final
- blockBackgroundInteraction → bool
-
Determines if user can interact with the screen behind it
If this is false, routeBlur and routeColor will be ignored
final
- borderColor → Color?
-
I do not recommend using it with showProgressIndicator or leftBarIndicatorColor.
final
- borderRadius → BorderRadius?
-
Adds a radius to corners specified of Flushbar. Best combined with margin.
I do not recommend using it with showProgressIndicator or leftBarIndicatorColor.
final
- borderWidth → double
-
Changes the width of the border if borderColor is specified
final
-
boxShadows
→ List<
BoxShadow> ? -
boxShadows The shadows generated by Flushbar. Leave it null if you don't want a shadow.
You can use more than one if you feel the need.
Check (this example)
https://github.com/flutter/flutter/blob/master/packages/flutter/lib/src/material/shadows.dart
final - dismissDirection → FlushbarDismissDirection
-
FlushbarDismissDirection.VERTICAL by default.
Can also be FlushbarDismissDirection.HORIZONTAL in which case both left and right dismiss are allowed.
final
- duration → Duration?
-
How long until Flushbar will hide itself (be dismissed). To make it indefinite, leave it null.
final
- endOffset → Offset?
-
Offset to be added to the end Flushbar position.
Intended to replace margin when you need items below Flushbar to be accessible
final
- flushbarPosition → FlushbarPosition
-
Flushbar can be based on FlushbarPosition.TOP or on FlushbarPosition.BOTTOM of your screen.
FlushbarPosition.BOTTOM is the default.
final
-
flushbarRoute
↔ FlushbarRoute<
T?> ? -
getter/setter pair
- flushbarStyle → FlushbarStyle
-
Flushbar can be floating or be grounded to the edge of the screen.
If grounded, I do not recommend using margin or borderRadius. FlushbarStyle.FLOATING is the default
If grounded, I do not recommend using a backgroundColor with transparency or barBlur
final
- forwardAnimationCurve → Curve
-
The Curve animation used when show() is called. Curves.easeOut is default
final
- hashCode → int
-
The hash code for this object.
no setterinherited
- icon → Widget?
-
You can use any widget here, but I recommend Icon or Image as indication of what kind
of message you are displaying. Other widgets may break the layout
final
- isDismissible → bool
-
Determines if the user can swipe or click the overlay (if routeBlur > 0) to dismiss.
It is recommended that you set duration != null if this is false.
If the user swipes to dismiss or clicks the overlay, no value will be returned.
final
- key → Key?
-
Controls how one widget replaces another widget in the tree.
finalinherited
- leftBarIndicatorColor → Color?
-
If not null, shows a left vertical bar to better indicate the humor of the notification.
It is not possible to use it with a Form and I do not recommend using it with LinearProgressIndicator
final
- mainButton → Widget?
-
Use if you need an action from the user. TextButton is recommended here
final
- margin → EdgeInsets
-
Adds a custom margin to Flushbar
final
- maxWidth → double?
-
Used to limit Flushbar width (usually on large screens)
final
- message → String?
-
The message displayed to the user.
final
- messageColor → Color?
-
Color message displayed to the user ? default is black
final
- messageSize → double?
-
The message text size displayed to the user.
final
- messageText → Widget?
-
Replaces message. Although this accepts a Widget, it is meant to receive Text or RichText
final
- onStatusChanged → FlushbarStatusCallback?
-
A callback for you to listen to the different Flushbar status
final
- onTap → OnTap?
-
A callback that registers the user's click anywhere. An alternative to mainButton
final
- padding → EdgeInsets
-
Adds a custom padding to Flushbar
The default follows material design guide line
final
- positionOffset → double
-
final
- progressIndicatorBackgroundColor → Color?
-
A LinearProgressIndicator configuration parameter.
final
- progressIndicatorController → AnimationController?
-
An optional AnimationController when you want to control the progress of your LinearProgressIndicator.
You are responsible for controlling the progress
final
-
progressIndicatorValueColor
→ Animation<
Color> ? -
A LinearProgressIndicator configuration parameter.
final
- reverseAnimationCurve → Curve
-
The Curve animation used when dismiss() is called. Curves.fastOutSlowIn is default
final
- routeBlur → double?
-
Default is 0.0. If different than 0.0, creates a blurred
overlay that prevents the user from interacting with the screen.
The greater the value, the greater the blur.
It does not take effect if blockBackgroundInteraction is false
final
- routeColor → Color?
-
Default is Colors.transparent. Only takes effect if routeBlur > 0.0.
Make sure you use a color with transparency here e.g. Colors.grey
600
.withOpacity(0.2). It does not take effect if blockBackgroundInteraction is falsefinal - runtimeType → Type
-
A representation of the runtime type of the object.
no setterinherited
- shouldIconPulse → bool
-
An option to animate the icon (if present). Defaults to true.
final
- showProgressIndicator → bool
-
True if you want to show a LinearProgressIndicator.
If progressIndicatorController is null, an infinite progress indicator will be shown
final
- textDirection → TextDirection
-
TextDirection.ltr by default
added to support rtl languages
final
- title → String?
-
The title displayed to the user
final
- titleColor → Color?
-
Color title displayed to the user ? default is black
final
- titleSize → double?
-
The title text size displayed to the user
final
- titleText → Widget?
-
Replaces title. Although this accepts a Widget, it is meant to receive Text or RichText
final
- userInputForm → Form?
-
A TextFormField in case you want a simple user input. Every other widget is ignored if this is not null.
final
Methods
-
createElement(
) → StatefulElement -
Creates a StatefulElement to manage this widget's location in the tree.
inherited
-
createState(
) → State< StatefulWidget> -
Creates the mutable state for this widget at a given location in the tree.
override
-
debugDescribeChildren(
) → List< DiagnosticsNode> -
Returns a list of DiagnosticsNode objects describing this node's
children.
inherited
-
debugFillProperties(
DiagnosticPropertiesBuilder properties) → void -
Add additional properties associated with the node.
inherited
-
dismiss(
[T? result]) → Future< T?> -
Dismisses the flushbar causing is to return a future containing
result
. When this future finishes, it is guaranteed that Flushbar was dismissed. -
isAppearing(
) → bool -
isDismissed(
) → bool - Checks if the flushbar is dismissed
-
isHiding(
) → bool -
isShowing(
) → bool - Checks if the flushbar is visible
-
noSuchMethod(
Invocation invocation) → dynamic -
Invoked when a nonexistent method or property is accessed.
inherited
-
show(
BuildContext context) → Future< T?> - Show the flushbar. Kicks in FlushbarStatus.IS_APPEARING state followed by FlushbarStatus.SHOWING
-
toDiagnosticsNode(
{String? name, DiagnosticsTreeStyle? style}) → DiagnosticsNode -
Returns a debug representation of the object that is used by debugging
tools and by DiagnosticsNode.toStringDeep.
inherited
-
toString(
{DiagnosticLevel minLevel = DiagnosticLevel.info}) → String -
A string representation of this object.
inherited
-
toStringDeep(
{String prefixLineOne = '', String? prefixOtherLines, DiagnosticLevel minLevel = DiagnosticLevel.debug}) → String -
Returns a string representation of this node and its descendants.
inherited
-
toStringShallow(
{String joiner = ', ', DiagnosticLevel minLevel = DiagnosticLevel.debug}) → String -
Returns a one-line detailed description of the object.
inherited
-
toStringShort(
) → String -
A short, textual description of this widget.
inherited
Operators
-
operator ==(
Object other) → bool -
The equality operator.
inherited