Aus öffentlichen Paketdaten erstellte Orientierung.
Pie_menu ist ein Flutter-Paket, das ein anpassbares kreisförmiges oder radiales Kontextmenü bietet, ideal für intuitive und platzsparende Benutzerinteraktionen. Es ermöglicht Entwicklern die Erstellung interaktiver, pie-artiger Menüs mit konfigurierbaren Segmenten, Animationen und Gesten. Das Paket unterstützt mehrere Plattformen wie Android, iOS, Web, macOS, Windows und Linux und sorgt für konsistentes Verhalten über Geräte hinweg. Mit umfangreichen Anpassungsmöglichkeiten für Farben, Größen und Verhaltensweisen verbessert es die UI-Gestaltung in Apps, die schnellen Zugriff auf mehrere Aktionen erfordern.
Anwendungsfälle
Schnellauswahl in mobilen Apps
Intuitive Navigation in kreativen Tools
Verbesserung der Benutzeroberfläche in Spieloberflächen
Workflows in Produktivitäts-Apps optimieren
Bereitstellung von gestenbasierten Steuerungen in AR/VR-Anwendungen
Hauptmerkmale
Hochgradig anpassbarer Radial-Layout
Unterstützung für Berühr-, Tip- und Ziehgesten
Glatte Animationen und Übergänge
Plattformübergreifende Kompatibilität
Konfigurierbare Scheibengröße und -abstand
Erweiterbare Ereignisverarbeitung
Geeignet für
Entwickler, die gestenreiche Schnittstellen erstellen
UI-Designer, die moderne Menüalternativen suchen
Apps, die kompakte Aktionen-Panels erfordern
Interaktive Bildungs- oder Spielanwendungen
Projekte, die mehrere Geräteplattformen ansprechen
Hinweise
Kann sorgfältige UX-Tests für Barrierefreiheit erfordern
Leistungseinfluss bei vielen Menüelementen
Potenzielle Lernkurve bei komplexen Konfigurationen
Nicht ideal für einfache lineare Menüs
Auf die Berührungszielgröße auf kleinen Bildschirmen achten
Original-README
Originaler README-Schnappschuss aus dem verknüpften Quell-Repository. Aktuelle Inhalte finden Sie im Repository.
Flutter Pie Menu 🥧
A Flutter package providing a highly customizable circular/radial context menu, similar to Pinterest's.
Wrap the widget that should respond to gestures with the PieMenu widget, and provide the menu with a list of PieActions to display as circular buttons.
PieMenu(
onPressed: () => print('pressed'),
actions: [
PieAction(
tooltip: constText('like'),
onSelect: () => print('liked'),
child: constIcon(Icons.favorite), // Can be any widget
),
],
child: ChildWidget(),
),
💡 Note that PieMenu must be a descendant of a PieCanvas widget.
Wrap your page, or any other desired widget for drawing the menu and the background overlay, with the PieCanvas widget.
For instance, if you want the menu to be displayed at the forefront, wrap your Scaffold with a PieCanvas as follows:
Button background and icon colors are defined by the theme's buttonTheme and buttonThemeHovered properties. You can create custom PieButtonTheme instances for your canvas and menu themes.
To disable dynamic angle calculation and have the menu appear at a fixed angle, set the customAngle and customAngleAnchor attributes of PieTheme.
PieTheme(
customAngle: 90, // In degrees
customAngleAnchor: PieAnchor.center, // start, center, end
),
You can also use customAngleDiff or spacing to adjust the angle between buttons, and angleOffset to rotate the menu.
Specific menu position
Use the menuAlignment attribute of PieTheme to make the menu appear at a specific position regardless of the press location. Combine it with menuDisplacement to fine-tune the position.
To open, close, or toggle a menu programmatically, assign a PieMenuController to it.
// Create a controller inside a stateful widget.final _pieMenuController = PieMenuController();
// Assign the controller to a PieMenu.PieMenu(
controller: _pieMenuController,
...
),
// Control the menu using the controller.
_pieMenuController.open(
menuAlignment: Alignment.center,
);
If you need to perform actions when the menu is toggled, use the onToggle callback of PieMenu or the onMenuToggle callback of PieCanvas.