Pakete, Repositories und App-Kategorien suchen

Cover von screen_loader
Paketdetailsv4.0.1

screen_loader

Einfach zu verwendendes Mixin ScreenLoader, das die Ladevorgänge auf dem Bildschirm ohne Verwendung von Status oder Navigationstack verarbeitet. Sie können den Ladevorgang auch anpassen.

AndroidiOSWebmacOSWindowsLinux
30-Tage-Downloads
1470
Likes
50
Pub-Punkte
150

Paket installieren

flutter pub add screen_loader

Paketübersicht

Aus öffentlichen Paketdaten erstellte Orientierung.

ScreenLoader ist ein Flutter/Dart-Paket, das einen einfachen Mixin zum Verwalten von Ladezuständen auf dem Bildschirm bereitstellt, ohne dass eine explizite Zustandsverwaltung oder Manipulation des Navigationsstapels erforderlich ist. Es ermöglicht Entwicklern, Ladeindikatoren über mehrere Bildschirme hinweg mit minimalem Boilerplate anzuzeigen und zu steuern. Das Paket unterstützt die Anpassung der Lade-Oberfläche, wodurch es sich an verschiedene Gestaltungsanforderungen anpassen lässt. Ideal für Apps, die konsistente, wiederverwendbare Ladeerfahrungen über mehrere Widgets hinweg benötigen.

Anwendungsfälle

  • Ladenüberlagerungen während asynchroner Operationen anzeigen
  • Vereinfachung der Ladezustandsverwaltung in Formularen
  • Ladeindikatoren zu API-Aufrufen hinzufügen
  • Wiederverwendbare Ladekomponenten erstellen
  • Verbesserung der Benutzererfahrung durch reibungslose Ladeübergänge
  • Verringern von Boilerplate in der Bildschirm-Lade-Logik

Hauptmerkmale

  • Mixin-basierte Ladeimplementierung
  • Anpassbare Lade-UI
  • Kein Zustandsmanagement erforderlich
  • Läuft auf allen Plattformen
  • Minimale Einrichtung erforderlich
  • Unterstützt die Behandlung asynchroner Operationen

Geeignet für

  • Entwickler, die nach leichtgewichtigen Lösungen für das Laden suchen
  • Teams, die minimalen Statusmanagement verwenden
  • Apps mit häufiger asynchroner Datenabruf
  • UI-intensiven Anwendungen, die konsistente Loader benötigen
  • Flutter-Anfänger erkunden Lade-Muster
  • Plattformübergreifende Anwendungen für mehrere Geräte

Hinweise

  • Beschränkt auf grundlegende Ladefunktionen
  • Benötigt manuelle Integration mit asynchronen Workflows
  • Nicht geeignet für komplexe Ladezustände
  • Möglicherweise sind zusätzliche Stile für benutzerdefinierte Designs erforderlich
  • Abhängig von der korrekten Widget-Baumstruktur
  • Behandelt Fehlerzustände standardmäßig nicht

Original-README

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

screen_loader

Why ScreenLoader?

  1. With the help of stream_mixin, it shows and hides the loader without updating the state of the widget which increases the performance
  2. It does not push any sort of widget to navigation stack, this helps in not messing up the navigation stack and context
  3. Easy to use, just use your screen with ScreenLoader mixin and wrap the widget with loadableWidget
  4. The loader is customizable. You can use any widget as a loader
  5. You can configure same loader for all the screens at once
  6. You can also configure different loader for different screens

Basic usage

  1. Use your screen with the ScreenLoader mixin
  2. Wrap the widget with loadableWidget
  3. Use performFuture function to show loader while your future is being performed

Configure different loader for individual screen

Simply overide loader() method

loader() {
    // here any widget would do
    return AlertDialog(
        title: Text('Wait.. Loading data..'),
    );
}

Configure the loader for all screens at once

void main() {
  configScreenLoader(
    loader: AlertDialog(
      title: Text('Gobal Loader..'),
    ),
    bgBlur: 20.0,
  );
  runApp(MyApp());
}

Priority of loaders (highest first)

  • Local loader: the one you override in your widget
  • Global loader: the one you specify in configScreenLoader. Note: if you don't override local(), this loader will be used
  • Default loader: if you don't specify global loader or override local loader, this loader will be used

Migration guide to 4.0.0

  1. ScreenLoaderApp widget is removed. Now no need to wrap your App around any widget just to set the global configurations. Instead call configScreenLoader() before runApp()
-void main() => runApp(MyApp());
+void main() {
+  configScreenLoader(
+    loader: AlertDialog(
+      title: Text('Gobal Loader..'),
+    ),
+    bgBlur: 20.0,
+  );
+  runApp(MyApp());
+}
 
 class MyApp extends StatelessWidget {
   @override
   Widget build(BuildContext context) {
-    return ScreenLoaderApp(
-      app: MaterialApp(
-        debugShowCheckedModeBanner: false,
-        title: 'Screen Loader',
-        theme: ThemeData(
-          primarySwatch: Colors.blue,
-        ),
-        home: Screen(),
-      ),
-      globalLoader: AlertDialog(
-        title: Text('Gobal Loader..'),
+    return MaterialApp(
+      debugShowCheckedModeBanner: false,
+      title: 'Screen Loader',
+      theme: ThemeData(
+        primarySwatch: Colors.blue,
       ),
-      globalLoadingBgBlur: 20.0,
+      home: Screen(),
     );
   }
 }
  1. Instead of replacing the build function with screen use the build function itself and wrap the widget you want to show loader on with the loadableWidget.

-class _ScreenState extends State<Screen> with ScreenLoader<Screen> {
+class _ScreenState extends State<Screen> with ScreenLoader {
   @override
   loader() {
     return AlertDialog(
@@ -49,17 +51,19 @@ class _ScreenState extends State<Screen> with ScreenLoader<Screen> {
   }
 
   @override
-  Widget screen(BuildContext context) {
-    return Scaffold(
-      appBar: AppBar(
-        title: Text('ScreenLoader Example'),
-      ),
-      body: _buildBody(),
-      floatingActionButton: FloatingActionButton(
-        onPressed: () async {
-          await this.performFuture(NetworkService.getData);
-        },
-        child: Icon(Icons.refresh),
+  Widget build(BuildContext context) {
+    return loadableWidget(
+      child: Scaffold(
+        appBar: AppBar(
+          title: Text('ScreenLoader Example'),
+        ),
+        body: _buildBody(),
+        floatingActionButton: FloatingActionButton(
+          onPressed: () async {
+            await this.performFuture(NetworkService.getData);
+          },
+          child: Icon(Icons.refresh),
+        ),
       ),
     );
   }

PS
  • PRs are welcome
  • Please raise issues on https://github.com/arnold-parge/screen_loader.
  • Open for suggestions ❤️

Kategorien

Abhängigkeiten

Abhängigkeiten 1 Einträge

Quell-Repository

Projekte, die dieses Paket verwenden

Noch keine Daten verfügbar.