搜尋套件、儲存庫與 APP 分類

套件詳情v2.2.0

flutter_gutter

讓您的UI脫離雜亂!確保所有組件之間的視覺間距一致,適應軸向方向,並能回應螢幕尺寸。

AndroidiOSWebmacOSWindowsLinux
近 30 天下載
3120
喜歡數
65
Pub 分數
150

安裝套件

flutter pub add flutter_gutter

套件介紹

根據套件公開資料產生的選型評估,僅供參考。

Flutter Gutter 是一個響應式 UI 工具包,可確保在不同螢幕尺寸和軸向方向上,元件之間的間距保持一致。它透過根據方向(水平或垂直)和裝置尺寸自動調整內邊距和外邊距,簡化佈局管理,幫助開發者無需手動計算即可維持整潔、對齊的介面。非常適合建立流暢、可擴展的設計,在任何平台上看起來都很專業。

適用情境

  • 使用一致的間距創建響應式佈局
  • 跨方向自動調整填入/邊距
  • 為多平台應用建構可適應的使用者介面
  • 在動態小部件排列中保持視覺和諧
  • 使用最少的程式碼簡化複雜的版面邏輯
  • 透過統一的間距確保可存取性

主要特色

  • 自動軸感知間距
  • 對螢幕尺寸變更做出回應
  • 支援所有主要平台
  • 所需的最小樣板程式碼
  • 用於水平和垂直間距的直觀 API
  • 與現有 Flutter 小部件無縫整合

適合對象

  • 專注於響應式設計的開發人員
  • 建構跨平台應用程式的團隊
  • UI/UX 設計師實現一致的間距
  • 需要自適應佈局的項目
  • 初學者學習Flutter佈局原則
  • 針對多樣螢幕尺寸的應用

使用建議

  • 可能需要調整以滿足高度自定義的間距需求
  • 僅限與間距相關的功能
  • 不適用於非佈局使用案例
  • 取決於對Flutter佈局系統的正確使用
  • 最佳搭配其他佈局工具以實現複雜設計
  • 不取代完整的佈局框架,例如 Flex 或 Grid

原始 README

以下為關聯原始碼儲存庫的 README 原文快照,最新內容請造訪原始碼儲存庫。

Flutter Gutter

Pub Version GitHub Workflow Status

Ensure all visual gaps between your widgets are consistent, adapted to the axis direction, and respond to screen size!

Core Features

Provides a Gutter and Margin that correspond to Material Design's Responsive Layout system.

Gutters and margins:

  1. Create a vertical gap in vertical layouts (Column, vertical Scrollable, etc) and a horizontal gap in horizontal layouts (Row, horizontal Scrollable, etc).
  2. 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:

  1. 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).
  2. widget is a scrollable with a defined axis.
  3. 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:

return Column(
  children: [
    const Text('I hate using sized box.'),
    SizedBox(height: 10),
    const Text('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:

return Column(
  children: [
    const Text('I hate using sized box.'),
    Gutter(),
    const Text('And now I don\'t have to!'),
  ],
);

To use the gutter sizes directly, use the extension on context:

return Padding(
  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:

return GutterConfiguration(
  data: GutterConfigurationData(
    widgetToAxis: (widget) {
      if (widget is MyCustomColumn) {
        return Axis.vertical;
      }
      return null;
    },
  ),
  child: MyCustomColumn(
    children: [
      const Text('This widget isn\'t supported by `Gutter` ).'),
      Gutter(),
      const Text('But with `GutterConfiguration` I can make Gutter work with any widget!'),
    ],
  ),
);

Why not just use the existing Gap package?

Gap and Flutter Gutter are very similar, but Flutter Gutter does a few extra things Gap does not:

  1. Auto sizes gap spacing according to the Material breakpoints system (see "Core Features" above).
  2. Detects the axis of ANY widget that exposes an Axis direction attribute or getter (see "Supported Widgets" above).
  3. 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!

所屬分類

依賴

依賴清單 1 項

  • flutter_adaptive_scaffold>=0.3.0 <1.0.0

原始碼儲存庫

使用此套件的專案