hyper_snackbar 0.2.0

hyper_snackbar: ^0.2.0 copied to clipboard

⚠️ BREAKING CHANGES #

• Static API by Default: The HyperSnackbar class is now fully static. This makes the API more intuitive and similar to popular packages like GetX. You no longer need to instantiate it.

  Before:

  HyperSnackbar().show(config);
  

  After:

  HyperSnackbar.show(...); // With named parameters
  // Old usage style (with HyperConfig object) is now available via `HyperSnackbar.showFromConfig(config);`
  

• Simplified show Method: The primary show method no longer takes a HyperConfig object. Instead, it now accepts named parameters directly, significantly improving ease of use for one-off snackbars.

  Before:

  HyperSnackbar().show(HyperConfig(
    title: 'Success',
    message: 'Your file was saved.'
  ));
  

  After:

  HyperSnackbar.show(
    title: 'Success',
    message: 'Your file was saved.'
  );
  // Old usage style (with HyperConfig object) is now available via `HyperSnackbar.showFromConfig(config);`
  

✨ Features #

• Intuitive API: The new static API (HyperSnackbar.show(...)) is cleaner, requires less boilerplate, and is easier to discover.

  // The simplest way to show a snackbar:
  HyperSnackbar.show(title: 'Hello World!');
  

• Configuration Reusability: Added the HyperSnackbar.showFromConfig(config) method. This allows you to create a reusable HyperConfig object for styles that you use frequently, offering the best of both worlds.

  // Define a reusable style
  final myErrorStyle = HyperConfig(
    backgroundColor: Colors.red,
    // ... other properties
  );
  
  // Reuse it anywhere
  HyperSnackbar.showFromConfig(
    myErrorStyle.copyWith(title: 'Error 1')
  );
  HyperSnackbar.showFromConfig(
    myErrorStyle.copyWith(title: 'Error 2')
  );
  

• Updated BuildContext Extension: The context.showHyperSnackbar() extension has also been updated to use named parameters for a consistent and convenient API.

• Improved documentation comments.

✨ Features #

• Manual Dismissal: Added dismissById(String id) to close specific snackbars programmatically.
• Clear All: Added clearAll() to close all visible snackbars at once.

• Fix README formatting.

⚠️ Breaking Changes #

• Renamed Main Class: HyperManager has been renamed to HyperSnackbar to be more intuitive.

✨ Features #

• Context-less Usage: Added support for showing snackbars without a BuildContext.
  • Note: To use this feature, you must assign HyperSnackbar.navigatorKey to the navigatorKey property of your MaterialApp.
• Hybrid Support: The show method now accepts an optional context. If provided, it uses the local context (ideal for inheriting themes); otherwise, it falls back to the global navigator key.
• Extension Method: Added context.showHyperSnackbar(config) for easier usage within widgets.

• Documents update.

• Initial complete release.

• Update README.md.
• Add Demo.gif

• Initial release.