Pakete, Repositories und App-Kategorien suchen

Paketdetailsv3.4.0

statemachine

Ein einfaches, aber leistungsstarkes Zustandsmaschinen-Framework für Dart mit Unterstützung für Flutter und Web-Anwendungen.

AndroidiOSWebmacOSWindowsLinux
30-Tage-Downloads
15.400
Likes
49
Pub-Punkte
160

Paket installieren

flutter pub add statemachine

Paketübersicht

Aus öffentlichen Paketdaten erstellte Orientierung.

Ein leichtgewichtiges und flexibles Zustandsmaschinen-Framework für Dart, das entwickelt wurde, um die Zustandsverwaltung in Flutter- und Web-Anwendungen zu vereinfachen. Es bietet eine klare Struktur zur Definition von Zuständen, Übergängen und Aktionen, wodurch vorhersehbare und wartbare Anwendungslogik ermöglicht wird. Das Paket unterstützt sowohl synchrone als auch asynchrone Übergänge und ist daher für komplexe Workflows wie Formularverarbeitung, Authentifizierungsabläufe und UI-Navigation geeignet. Mit Fokus auf Einfachheit und Leistung entworfen, lässt es sich nahtlos in bestehende Projekte integrieren, ohne schwere Abhängigkeiten einzuführen.

Anwendungsfälle

  • Komplexe UI-Arbeitsabläufe verwalten
  • Behandlung von Mehrschrittformularen
  • Authentifizierungsabläufe implementieren
  • App-Navigation steuern
  • Modellierung von Spiel- oder Prozesszuständen

Hauptmerkmale

  • Einfache API zum Definieren von Zuständen und Übergängen
  • Unterstützung für synchrone und asynchrone Aktionen
  • Eingebaute ereignisgesteuerte Architektur
  • Durch benutzerdefinierte Wächter und Listener erweiterbar
  • Leichtgewichtig und abhängigkeitsfrei

Geeignet für

  • Entwickler, die strukturierte Zustandsverwaltung suchen
  • Projekte mit vorhersehbaren Zustandsübergängen
  • Apps mit komplexen Benutzerinteraktionen
  • Teams, die minimalen Boilerplate benötigen

Hinweise

  • Nicht ideal für einfache Zustandsänderungen
  • Erfahrung mit Zustandsmaschinen-Konzepten erforderlich
  • Begrenzte integrierte Debugging-Tools
  • Am besten geeignet für Apps mit gut definierten Zustandsgrenzen

Original-README

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

State Machine

Pub Package Build Status Code Coverage GitHub Issues GitHub Forks GitHub Stars GitHub License

A simple, yet powerful state machine framework for Dart supporting Flutter and web apps.

This library is open source, stable and well tested. Development happens on GitHub. Feel free to report issues or create a pull-request there. General questions are best asked on StackOverflow.

The package is hosted on dart packages. Up-to-date class documentation is created with every release.

Tutorial

Installation

Follow the installation instructions on dart packages.

Import the package into your Dart code using:

import 'package:statemachine/statemachine.dart';
Creating a machine

To create a new state machine instantiate Machine:

final machine = Machine<String>();

The type of the state machine is used to uniquely identify states of the machine. In this simple example we use a String; but typically you would use an enum, a Symbol, or an arbitrary other identifying object.

Defining states

To create states call Machine.newState and store them in variables. Each state needs an identifying key of the declared type, as described above we use a String that helps debugging.

final startState = machine.newState('start');
final activeState = machine.newState('active');

By default, the first state created is also the start state of the machine. It is possible to explicitly create start and stop states of the machine using Machine.newStartState and Machine.newStopState.

Callbacks on states

States support callbacks whenever a state is entered or left.

someState.onEntry(() => print('activated'));
someState.onExit(() => print('deactivate'));
Starting and stopping a machine

To start a state machine and set its state to its starting state call Machine.start:

machine.start();

Similarly, you can stop a machine by calling Machine.stop.

Transitioning between states

There are various ways in which your machine can switch states.

Manually triggered transition

From anywhere within your code you can enter a specific state by calling State.enter.

someState.enter();

Depending on context, it might be easier to set the current state using the accessor on the state machine itself:

machine.current = someState;

Alternatively, you can also use the identifying object to set the active state:

machine.current = 'active';
Event triggered transition

You can define transitions between states that are triggered by events using State.onStream. The example below registers for click events when the inactive state is entered. In case of a click event the callback is executed, and the state machine transitions into the new state:

someState.onStream(element.onClick, (value) => anotherState.enter());
Future completion transition

Also, transitions can be triggered by the completion of a future using State.onFuture. Since futures cannot be suspended or cancelled, the future continues to run even if the owning state is deactivated. Should the state be activated, and the future value is already present, then the value is immediately supplied into the callback. Further activations have no effect.

someState.onFuture(computation, (value) => anotherState.enter());
Time based transition

Also, you can automatically trigger callbacks after a timeout using State.onTimeout. The following snippet calls the callback 1 second after the active state is entered and falls back to another state:

someState.onTimeout(Duration({seconds: 1}), () => anotherState.enter());

Callbacks often contain code to check for additional constraints and update other objects or UI element before entering a different state. See the tooltip example directory for a more complete illustration of the functionality provided by this library.

Nested machines

Machines can be nested. Simply add another machine that gets started when the state is entered, and stopped when the state is left.

someState.addNested(anotherMachine);

Misc

Resources
License

The MIT License, see LICENSE.

Kategorien

Abhängigkeiten

Abhängigkeiten 1 Einträge

Quell-Repository

Projekte, die dieses Paket verwenden