black_hole_flutter 1.2.0

black_hole_flutter: ^1.2.0 copied to clipboard

🛠 A package absorbing all Flutter utility functions, including extension functions and commonly used widgets.

• 📄 Bottom Sheet
• 🏗 BuildContext
• 🎨 Colors
  • 🌈 Material Design colors
• 🧭 Navigation
• 📱 Widgets
  • 🔳 Buttons
  • 🥙 FillOrWrap
  • 🎯 LeftCenterRight
  • 🟢 Circle
• 🖼 RenderObject
• ↕ Size

📄 Bottom Sheet #

Show modal bottom sheets using: context.showModalBottomSheet().

Also, this package adds a custom FancyBottomSheet with a drag indicator at the top. You can create one using context.showFancyModalBottomSheet().

🏗 BuildContext #

In Flutter, you often see the pattern <Class>.of(context) (e.g., Theme.of(context)). This package adds extension getters on BuildContext for those classes so you can just say:

🎨 Colors #

Handy extensions on Brightness:

isDark, isLight, and contrastColor can also be used on ThemeData directly.

Handy extensions on Color:

And if you can't decide on a color, just use random.nextColor(), random.nextColorHsl() or random.nextColorHsv()!

Convert between alpha and opacity with int.alphaToOpacity and double.opacityToAlpha.

🌈 Material Design colors #

Material Design specifies different opacities of white and black colors to use for text of different emphases on colored backgrounds. You can now use the highEmphasisOnColor, mediumEmphasisOnColor and disabledOnColor extension getters on Color to make your text legible! The raw opacity values are also available as MaterialColors.highEmphasisTextAlpha, MaterialColors.mediumEmphasisTextAlpha, and MaterialColors.disabledTextAlpha.

🧭 Navigation #

Access your navigation-related information via extension methods:

Push a new route and pop all previous routes (e.g., when signing out the user):

navigator.pushAndRemoveAll(/* new route */);
// Or using a named route:
navigator.pushNamedAndRemoveAll(/* route name */);

Log navigation events to the console:

MaterialApp(
  navigatorObservers: [LoggingNavigatorObserver()],
  // ...
)
// Prints:
// Navigator: didPush /dashboard → /articles/12345
// Navigator: didPop /dashboard ← /articles/12345

Note: This uses the name of routes, so it only works with named routes.

📱 Widgets #

🔳 Buttons #

Did you ever want to show a progress indicator inside a button? Or were annoyed to conditionally set a Button's onPressed to disable it? Fear no more — black_hole_flutter has got you covered!

^{This screenshot only shows an excerpt of all available button types and variants.}

In FancyFab (a FloatingActionButton), FancyTextButton, FancyOutlinedButton, FancyElevatedButton, FancyFilledButton, and FancyIconButton, we introduce some new parameters:

• isLoading: Setting this to true shows a CircularProgressIndicator and disables this button. You can optionally specify a loadingChild (loadingLabel on FancyFab) to show next to the progress indicator.
• isEnabled: Settings this to false disables this button, even if onPressed is set.

🥙 FillOrWrap #

A layout with two different behaviors:

• By default, all children are positioned next to each other with equal widths. This is comparable to a Row with all children wrapped in Expanded.
• If the children are too wide to fit in a single line, or one child would become smaller than its reported minimum width, the children get positioned below each other ("wrapped"). This is similar to a Column with MainAxisSize.min.

🎯 LeftCenterRight #

A layout taking optional left, center, and right children. It will try to keep center in the center of itself, even if only one of left and right is set, or they have different widths.

🟢 Circle #

A circle with optional diameter, background color, padding, and child.

🖼 RenderObject #

When writing a custom layout, you might find this extension on ContainerRenderObjectMixin useful:

↕ Size #