Paketdetailsv3.0.1

status_alert

Zeigen Sie Apple-System-ähnliche selbstverbergende Statuswarnungen an. Sie eignen sich hervorragend zum Benachrichtigen des Benutzers, ohne dessen Arbeitsablauf zu stören.

AndroidiOSWebmacOSWindowsLinux

pub.dev API-Dokumentation Quellcode

30-Tage-Downloads: 698
Likes: 287
Pub-Punkte: 160

Paket installieren

flutter pub add status_alert

Paketübersicht

Aus öffentlichen Paketdaten erstellte Orientierung.

Ein Flutter-Paket, das systembasierte, selbstverbergende Statuswarnungen anzeigt, inspiriert von Apples UI. Diese unauffälligen Benachrichtigungen erscheinen kurz am oberen Bildschirmrand und verschwinden automatisch, wodurch sie ideal für Rückmeldungen ohne Störung des Nutzerflusses sind. Mit einem sauberen, minimalistischen Design unterstützt es mehrere Plattformen wie Android, iOS, Web, macOS, Windows und Linux. Das Paket ist leichtgewichtig und einfach zu integrieren und bietet reibungslose Animationen sowie zuverlässiges Verhalten auf verschiedenen Geräten.

Anwendungsfälle

Erfolgsmeldungen nach Formularabsendung anzeigen
Anzeige temporärer Fehlerbenachrichtigungen
Feedback zu Benutzeraktionen bereitstellen
Benachrichtigung von Benutzern über Hintergrundprozessaktualisierungen
Verbesserung der Benutzererfahrung durch subtile, nicht blockierende Warnungen

Hauptmerkmale

Selbstverbergende Benachrichtigungen
Apple-artiger visueller Entwurf
Plattformübergreifende Kompatibilität
Glatte Fade-in-/Fade-out-Animationen
Einfache API mit minimalem Setup
Konfigurierbare Dauer und Position

Geeignet für

Apps, die leichte Rückmeldung erfordern
Entwickler, die Benutzererfahrung priorisieren
Projekte für mehrere Plattformen
Benutzeroberflächen, bei denen Unterbrechungen vermieden werden müssen
Teams, die native-artige Warnungsstyling wünschen

Hinweise

Nicht geeignet für dauerhafte oder kritische Warnungen
Eingeschränkte Anpassungsmöglichkeiten über die grundlegende Gestaltung hinaus
Erfordert den richtigen Kontext für die korrekte Positionierung
Kann in komplexen Widget-Bäumen nicht wie erwartet funktionieren
Am besten geeignet für kurzlebige, nicht dringende Nachrichten

Original-README

Originaler README-Schnappschuss aus dem verknüpften Quell-Repository. Aktuelle Inhalte finden Sie im Repository.

Status Alert for Flutter

Display Apple system-like self-hiding status alerts. Well suited for notifying users without interrupting their flow.

Installing

dependencies:
  status_alert: ^2.0.0

import 'package:status_alert/status_alert.dart';

Basic Usage

StatusAlert.show(
  context,
  duration: Duration(seconds: 2),
  title: 'Subscribed',
  subtitle: 'You will be notified of new posts',
  configuration: IconConfiguration(icon: Icons.done),
  maxWidth: 260,
);

Parameters

Parameter	Type	Default	Description
`title`	`String?`	`null`	Main text
`subtitle`	`String?`	`null`	Secondary text
`configuration`	`PopupMediaConfiguration?`	`null`	Icon or custom widget
`duration`	`Duration`	`1300ms`	How long the alert stays visible
`backgroundColor`	`Color?`	Theme-based	Alert background
`blurPower`	`double`	`2.0`	Background blur sigma
`maxWidth`	`double?`	`null`	Max width on large screens
`alignment`	`Alignment`	`center`	Alert position on screen
`margin`	`EdgeInsets`	`all(40)`	Outer spacing
`padding`	`EdgeInsets`	`all(30)`	Inner spacing
`borderRadius`	`BorderRadius`	`circular(10)`	Corner radius
`dismissOnBackgroundTap`	`bool`	`false`	Dismiss when background is tapped
`onComplete`	`VoidCallback?`	`null`	Called after dismiss animation ends
`titleOptions`	`StatusAlertTextConfiguration?`	`null`	Title text styling
`subtitleOptions`	`StatusAlertTextConfiguration?`	`null`	Subtitle text styling

Media Configurations

Icon

StatusAlert.show(
  context,
  title: 'Done',
  configuration: IconConfiguration(
    icon: Icons.check_circle,
    color: Colors.green,
    size: 60,
  ),
);

Custom Widget (e.g. Rive animation)

StatusAlert.show(
  context,
  title: 'Loading',
  configuration: WidgetConfiguration(
    widget: RiveAnimation.asset('assets/animation.riv'),
  ),
);

Programmatic Control

// Show
StatusAlert.show(context, title: 'Saved');

// Hide manually
StatusAlert.hide();

// Check visibility
if (StatusAlert.isVisible) { ... }

`onComplete` Callback

Called after the alert finishes its dismiss animation:

StatusAlert.show(
  context,
  title: 'Uploaded',
  onComplete: () => Navigator.push(context, ...),
);

Migration from 1.x

1.x	2.x
`FlareConfiguration`	Use `WidgetConfiguration` with a Rive widget
`textScaleFactor` in `StatusAlertTextConfiguration`	Use `textScaler`
Dart SDK `<3.0.0`	Requires Dart `>=3.0.0`