Bibliothek zum Abrufen von Widget-Metriken. Verwendet RenderObject, um die Größe und Position von Widgets relativ zum Bildschirmfenster sowie den Unterschied zwischen Widgets zu ermitteln.
Aus öffentlichen Paketdaten erstellte Orientierung.
Das render_metrics-Paket bietet eine Möglichkeit, präzise Layoutmetriken für Widgets in Flutter-Anwendungen abzurufen. Durch die Nutzung von RenderObject ermöglicht es Entwicklern, genaue Größen- und Bildschirmpositionsinformationen für Widgets zu erhalten sowie Unterschiede zwischen Widget-Zuständen zu messen. Dies ist besonders nützlich zum Debuggen von Layoutproblemen, zur Implementierung benutzerdefinierter Animationen oder zur Erstellung von Überlagerungselementen, die sich an bestimmte UI-Komponenten anpassen. Die Bibliothek unterstützt alle wichtigen Plattformen, einschließlich Android, iOS, Web, macOS, Windows und Linux.
Anwendungsfälle
Debugging von Widget-Positionierung
Dynamische Überlagerungen erstellen
Messung von Layoutänderungen
Benutzerdefinierte Animationen implementieren
Analyse der Benutzeroberflächenleistung
Hauptmerkmale
Zugriff auf Widgetgröße und Bildschirmposition
Vergleich von Widget-Metriken im Zeitverlauf
Plattformübergreifende Kompatibilität
Integration mit RenderObject
Leichte und fokussierte API
Geeignet für
UI-Debugging-Tools
Benutzerdefinierte Layout-Hilfsmittel
Animationsframeworks
Entwicklerwerkzeuge
Leistungsanalyse
Hinweise
Zugriff auf den RenderObject-Kontext erforderlich
Kann die Leistung beeinträchtigen, wenn sie übermäßig verwendet wird
Nicht geeignet für Laufzeitmetriken in hochfrequenten Szenarien
Beschränkt auf sichtbare Widgets während der Darstellung
Original-README
Originaler README-Schnappschuss aus dem verknüpften Quell-Repository. Aktuelle Inhalte finden Sie im Repository.
Get a bundle with the positioning coordinates of the wrapped widget.
RenderData data = renderManager.getRenderData("uniqueWidgetId");
Calculating the difference in positioning between two widgets
Wrap the widgets you want to compare in RenderMetricsObjects. Specify two different ids for each of them. Please note, that the manager parameter of both widgets should contain the link to the same RenderParametersManager instance.
Specify two unique widget identifiers when using the getDiffById() function and extract a bundle with the relative difference in positioning coordinates between the widgets.
RenderData instance contains a complete set of properties that characterize any widget in a two-dimensional space.
All metrics positioning coordinates are global, meaning they are relative to the entire screen coordinate space.
RenderData also provides you an ability to get all widget keypoint XY-coordinates by calling one of special getters.
ComparisonDiff
You can get the comparison relative results for each widget keypoint from the ComparisonDiff instance.
An additional set of special getters can help you calculate the difference between two adjacent sides of two different widgets (e.g. right to left, top to bottom, etc.).
Installation
Add render_metrics to your pubspec.yaml file:
dependencies:render_metrics:$currentVersion$
At this moment, the current version of render_metrics is .
Changelog
All notable changes to this project will be documented in this file.
Issues
To report your issues, submit them directly in the Issues section.
Contribute
If you would like to contribute to the package (e.g. by improving the documentation, fixing a bug or adding a cool new feature), please read our contribution guide first and send us your pull request.
Your PRs are always welcome.
How to reach us
Please feel free to ask any questions about this package. Join our community chat on Telegram. We speak English and Russian.