Bringen Sie Ihre Benutzeroberfläche aus dem Schmutz! Stellen Sie sicher, dass alle sichtbaren Abstände zwischen Ihren Widgets konsistent sind, der Achsrichtung angepasst sind und auf Bildschirmgröße reagieren.
Aus öffentlichen Paketdaten erstellte Orientierung.
Flutter Gutter ist ein responsives UI-Utility-Paket, das eine konsistente Abstandsgestaltung zwischen Widgets bei unterschiedlichen Bildschirmgrößen und Achsrichtungen sicherstellt. Es vereinfacht die Layoutverwaltung, indem es Paddings und Margins automatisch an die Ausrichtung (horizontal oder vertikal) und die Geräteabmessungen anpasst, wodurch Entwickler saubere, ausgerichtete Oberflächen ohne manuelle Berechnungen aufrechterhalten können. Ideal für fließende, skalierbare Designs, die auf jeder Plattform professionell aussehen.
Anwendungsfälle
Responsive Layouts mit konsistentem Abstand erstellen
Automatisierung von Abstandsanpassungen zwischen Orientierungen
Anpassbare Benutzeroberflächen für Multiplattform-Apps erstellen
Visuelle Harmonie bei dynamischen Widget-Anordnungen aufrechterhalten
Komplexe Layout-Logik mit minimalem Code vereinfachen
Sicherstellung der Barrierefreiheit durch einheitlichen Abstand
Hauptmerkmale
Automatischer achsbezogener Abstand
Reagiert auf Änderungen der Bildschirmgröße
Unterstützt alle wichtigen Plattformen
Minimale Boilerplate-Anforderung
Intuitive API für horizontale und vertikale Abstände
Nahtlose Integration mit bestehenden Flutter-Widgets
Geeignet für
Entwickler, die sich auf responsive Design konzentrieren
Teams, die plattformübergreifende Anwendungen entwickeln
UI/UX-Designer, die konsistenten Abstand umsetzen
Projekte, die adaptive Layouts erfordern
Anfänger lernen Layout-Prinzipien von Flutter
Apps für unterschiedliche Bildschirmgrößen
Hinweise
Kann Anpassung für sehr individuelle Abstandsanforderungen erfordern
Beschränkt auf funktionale Aspekte im Zusammenhang mit Abständen
Nicht geeignet für Nicht-Layout-Anwendungsfälle
Abhängig von der korrekten Verwendung des Layout-Systems von Flutter
Am besten mit anderen Layout-Tools für komplexe Designs kombiniert
Ersetzt keine vollständigen Layout-Frameworks wie Flex oder Grid
Original-README
Originaler README-Schnappschuss aus dem verknüpften Quell-Repository. Aktuelle Inhalte finden Sie im Repository.
Flutter Gutter
Ensure all visual gaps between your widgets are consistent, adapted to the axis direction, and
respond to screen size!
Create a vertical gap in vertical layouts (Column, vertical Scrollable, etc) and a horizontal
gap in horizontal layouts (Row, horizontal Scrollable, etc).
Size the gap according to the current screen size and Material Design's corresponding breakpoint
definition (small gap on small screens, larger gap on large screens)
GutterTiny, GutterSmall, GutterLarge and GutterExtraLarge all provide gaps that are factors of the base gutter
size for situations where larger or smaller gaps are more appropriate. By default, each successive
gutter size is a factor of 2 larger than the previous.
For convenience, alternative constructors are provided (Gutter.tiny, etc.) for each gutter size.
For more flexibility, you can also use the provided extension on BuildContext to reference the
gutter and margin sizes directly (context.gutter, context.gutterLarge, context.margin, etc).
Use Gap to create an axis aligned spacing with an explicit size.
Supported Widgets
Flutter Gutter's widgets traverse up the widget tree until they find an ancestor that meets one of
the following conditions:
GutterConfiguration.maybeOf(context).customWidgetToAxis(widget) returns a non-null Axis (this
is a custom function that lets you extend Flutter Gutter to support arbitrary widgets).
widget is a scrollable with a defined axis.
widget has an Axis direction attribute (for example, Flutter Gutter supports
Boxy's widgets automatically).
Note that case 3 means that ANY widget with an axis is supported, however this is a dynamic check
which means that the Dart compiler will not be able to tree shake out any axis attributes on any
widget. This may increase your app's bundle size by a very small amount.
I have a Github issue against Flutter to add an explicit axis scope to Flutter which would
resolve this limitation. If you like using Flutter Gutter and want to see it improved, please upvote
the linked issue.
Example
Without flutter_gutter you have to manually specify the axis direction (by using height or
width) and specify size of the gap yourself:
returnColumn(
children: [
constText('I hate using sized box.'),
SizedBox(height: 10),
constText('If only there were a better way...'),
],
);
With flutter_gutter the Gutter widget identifies that it's in a vertical layout (Column) and
automatically creates a vertical gap. It also looks up the screen size and sizes the gap accordingly
so you don't have to specify a gap size manually:
returnColumn(
children: [
constText('I hate using sized box.'),
Gutter(),
constText('And now I don\'t have to!'),
],
);
To use the gutter sizes directly, use the extension on context:
returnPadding(
padding: EdgeInsets.only(left: context.gutter, right: context.gutterSmall),
child: Text('This is the margin size on this device: ${context.margin}'),
);
To use Gutter with custom widgets that don't expose an axis argument or to override the default
gutter spacing or scaling, use GutterConfiguration:
returnGutterConfiguration(
data: GutterConfigurationData(
widgetToAxis: (widget) {
if (widget isMyCustomColumn) {
returnAxis.vertical;
}
returnnull;
},
),
child: MyCustomColumn(
children: [
constText('This widget isn\'t supported by `Gutter` ).'),
Gutter(),
constText('But with `GutterConfiguration` I can make Gutter work with any widget!'),
],
),
);
Gap and Flutter Gutter are very similar, but Flutter Gutter does a few extra things Gap does not:
Auto sizes gap spacing according to the Material breakpoints system (see "Core Features" above).
Detects the axis of ANY widget that exposes an Axis direction attribute or getter (see
"Supported Widgets" above).
Allows you to add support for arbitrary widgets using GutterConfiguration and widgetToAxis.
Personally, I especially appreciate feature 1 as it makes it easier for me to add spacing and
ensures that spacing and padding in different parts of my app are consistently sized. However, if
none of the above features are important to you, you'll likely prefer the Gap package!