Flutter 佈局(一)- Container詳解

吹個大氣球發表於2018-06-03

本文主要介紹Flutter中非常常見的Container,列舉了一些實際例子介紹如何使用。

1. 簡介

A convenience widget that combines common painting, positioning, and sizing widgets.

Container在Flutter中太常見了。官方給出的簡介,是一個結合了繪製(painting)、定位(positioning)以及尺寸(sizing)widget的widget。

可以得出幾個資訊,它是一個組合的widget,內部有繪製widget、定位widget、尺寸widget。後續看到的不少widget,都是通過一些更基礎的widget組合而成的。

1.1 組成

Container的組成如下:

  • 最裡層的是child元素;
  • child元素首先會被padding包著;
  • 然後新增額外的constraints限制;
  • 最後新增margin。

Container的繪製的過程如下:

  • 首先會繪製transform效果;
  • 接著繪製decoration;
  • 然後繪製child;
  • 最後繪製foregroundDecoration。

Container自身尺寸的調節分兩種情況:

  • Container在沒有子節點(children)的時候,會試圖去變得足夠大。除非constraints是unbounded限制,在這種情況下,Container會試圖去變得足夠小。
  • 帶子節點的Container,會根據子節點尺寸調節自身尺寸,但是Container構造器中如果包含了width、height以及constraints,則會按照構造器中的引數來進行尺寸的調節。

1.2 佈局行為

由於Container組合了一系列的widget,這些widget都有自己的佈局行為,因此Container的佈局行為有時候是比較複雜的。

一般情況下,Container會遵循如下順序去嘗試佈局:

  • 對齊(alignment);
  • 調節自身尺寸適合子節點;
  • 採用width、height以及constraints佈局;
  • 擴充套件自身去適應父節點;
  • 調節自身到足夠小。

進一步說:

  • 如果沒有子節點、沒有設定width、height以及constraints,並且父節點沒有設定unbounded的限制,Container會將自身調整到足夠小。
  • 如果沒有子節點、對齊方式(alignment),但是提供了width、height或者constraints,那麼Container會根據自身以及父節點的限制,將自身調節到足夠小。
  • 如果沒有子節點、width、height、constraints以及alignment,但是父節點提供了bounded限制,那麼Container會按照父節點的限制,將自身調整到足夠大。
  • 如果有alignment,父節點提供了unbounded限制,那麼Container將會調節自身尺寸來包住child;
  • 如果有alignment,並且父節點提供了bounded限制,那麼Container會將自身調整的足夠大(在父節點的範圍內),然後將child根據alignment調整位置;
  • 含有child,但是沒有width、height、constraints以及alignment,Container會將父節點的constraints傳遞給child,並且根據child調整自身。

另外,margin以及padding屬性也會影響到佈局。

1.3 繼承關係

Object > Diagnosticable > DiagnosticableTree > Widget > StatelessWidget > Container
複製程式碼

從繼承關係可以看出,Container是一個StatelessWidget。Container並不是一個最基礎的widget,它是由一系列的基礎widget組合而成。

2. 原始碼解析

建構函式如下:

Container({
    Key key,
    this.alignment,
    this.padding,
    Color color,
    Decoration decoration,
    this.foregroundDecoration,
    double width,
    double height,
    BoxConstraints constraints,
    this.margin,
    this.transform,
    this.child,
  })
複製程式碼

平時使用最多的,也就是padding、color、width、height、margin屬性。

2.1 屬性解析

key:Container唯一識別符號,用於查詢更新。

alignment:控制child的對齊方式,如果container或者container父節點尺寸大於child的尺寸,這個屬性設定會起作用,有很多種對齊方式。

padding:decoration內部的空白區域,如果有child的話,child位於padding內部。padding與margin的不同之處在於,padding是包含在content內,而margin則是外部邊界,設定點選事件的話,padding區域會響應,而margin區域不會響應。

color:用來設定container背景色,如果foregroundDecoration設定的話,可能會遮蓋color效果。

decoration:繪製在child後面的裝飾,設定了decoration的話,就不能設定color屬性,否則會報錯,此時應該在decoration中進行顏色的設定。

foregroundDecoration:繪製在child前面的裝飾。

width:container的寬度,設定為double.infinity可以強制在寬度上撐滿,不設定,則根據child和父節點兩者一起佈局。

height:container的高度,設定為double.infinity可以強制在高度上撐滿。

constraints:新增到child上額外的約束條件。

margin:圍繞在decoration和child之外的空白區域,不屬於內容區域。

transform:設定container的變換矩陣,型別為Matrix4。

child:container中的內容widget。

2.2 一個例子

new Container(
  constraints: new BoxConstraints.expand(
    height:Theme.of(context).textTheme.display1.fontSize * 1.1 + 200.0,
  ),
  decoration: new BoxDecoration(
    border: new Border.all(width: 2.0, color: Colors.red),
    color: Colors.grey,
    borderRadius: new BorderRadius.all(new Radius.circular(20.0)),
    image: new DecorationImage(
      image: new NetworkImage('http://h.hiphotos.baidu.com/zhidao/wh%3D450%2C600/sign=0d023672312ac65c67506e77cec29e27/9f2f070828381f30dea167bbad014c086e06f06c.jpg'),
      centerSlice: new Rect.fromLTRB(270.0, 180.0, 1360.0, 730.0),
    ),
  ),
  padding: const EdgeInsets.all(8.0),
  alignment: Alignment.center,
  child: new Text('Hello World',
    style: Theme.of(context).textTheme.display1.copyWith(color: Colors.black)),
  transform: new Matrix4.rotationZ(0.3),
)
複製程式碼

這是官方文件給出例子的一個變種,包含屬性比較全,可以看下其用法。實際執行效果如下:

Container屬性用法

其中decoration可以設定邊框、背景色、背景圖片、圓角等屬性,非常實用。對於transform這個屬性,一般有過其他平臺開發經驗的,都大致瞭解,這種變換,一般不是變換的實際位置,而是變換的繪製效果,也就是說它的點選以及尺寸、間距等都是按照未變換前的。

2.3 原始碼

decoration = decoration ?? (color != null ? new BoxDecoration(color: color) : null),
複製程式碼

可以看出,對於顏色的設定,最後都是轉換為decoration來進行繪製的。如果同時包含decoration和color兩種屬性,則會報錯。

@override
  Widget build(BuildContext context) {
    Widget current = child;

    if (child == null && (constraints == null || !constraints.isTight)) {
      current = new LimitedBox(
        maxWidth: 0.0,
        maxHeight: 0.0,
        child: new ConstrainedBox(constraints: const BoxConstraints.expand())
      );
    }

    if (alignment != null)
      current = new Align(alignment: alignment, child: current);

    final EdgeInsetsGeometry effectivePadding = _paddingIncludingDecoration;
    if (effectivePadding != null)
      current = new Padding(padding: effectivePadding, child: current);

    if (decoration != null)
      current = new DecoratedBox(decoration: decoration, child: current);

    if (foregroundDecoration != null) {
      current = new DecoratedBox(
        decoration: foregroundDecoration,
        position: DecorationPosition.foreground,
        child: current
      );
    }

    if (constraints != null)
      current = new ConstrainedBox(constraints: constraints, child: current);

    if (margin != null)
      current = new Padding(padding: margin, child: current);

    if (transform != null)
      current = new Transform(transform: transform, child: current);

    return current;
  }
複製程式碼

Container的build函式不長,繪製也是一個線性的判斷的過程,一層一層的包裹著widget,去實現不同的樣式。

最裡層的是child,如果為空或者其他約束條件,則最裡層包含的為一個LimitedBox,然後依次是Align、Padding、DecoratedBox、前景DecoratedBox、ConstrainedBox、Padding(實現margin效果)、Transform。

Container的原始碼本身並不複雜,複雜的是它的各種佈局表現。我們謹記住一點,如果內部不設定約束,則按照父節點儘可能的擴大,如果內部有約束,則按照內部來。

2.4 使用場景

Container算是目前專案中,最經常用到的一個widget。在實際使用過程中,筆者在以下情況會使用到Container,當然並不是絕對的,也可以通過其他widget來實現。

  • 需要設定間隔(這種情況下,如果只是單純的間隔,也可以通過Padding來實現);
  • 需要設定背景色;
  • 需要設定圓角或者邊框的時候(ClipRRect也可以實現圓角效果);
  • 需要對齊(Align也可以實現);
  • 需要設定背景圖片的時候(也可以使用Stack實現)。

3. 例子

接下來我們試著去做一個圓角按鈕,它包含以下特性:

  • 支援設定按鈕的三種狀態(正常態、點選態、禁用態)的色值;
  • 支援設定按鈕標題;
  • 支援設定寬高;
  • 支援點選回撥;

根據上面介紹,利用decoration這個屬性,基本上就可以完成效果了,至於點選效果以及點選回撥,則使用一個GestureDetector就可以完成了。實際的例子非常簡單,在這裡就不貼程式碼了。實際執行效果如下所示:

Container樣例

3.1 注意事項

這個小控制元件,寫起來很簡單,本身沒有什麼難度,只是純粹的介紹了Container的使用方法,但是有一個地方需要注意的。在控制元件的deactivate狀態,我們需要將控制元件的屬性初始到最開始的狀態,例如在本例中,有如下程式碼:

  @override
  void deactivate() {
    super.deactivate();
    currentColor = widget.backgroundColor;
  }
複製程式碼

這麼做是為什麼了?是因為在點選按鈕進行頁面跳轉的時候,按鈕處在點選態,當我們返回的時候,頁面還是處在點選態,這顯然就不正確了,因此需要我們手動的在deactivate狀態下,將控制元件恢復到初始狀態。但是呢,這個設定顏色,並不是說在deactivate的時候,就立馬去重新整理控制元件,而是在下次再進入這個頁面的時候,再次執行build的時候,會按照這個初始值進行繪製,也就是恢復到了最開始的狀態。

3.2 程式碼

程式碼Github地址,這是一個系列的專案,如果不出意外,會將Flutter中常見的二十多種佈局widget都介紹一下。

4. 後話

筆者建了一個flutter學習相關的專案,github地址,裡面包含了筆者寫的關於flutter學習相關的一些文章,會定期更新,也會上傳一些學習demo,歡迎大家關注。

5. 參考

  1. Container class

相關文章