Flutter 佈局(三)- FittedBox、AspectRatio、ConstrainedBox詳解

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

本文主要介紹Flutter佈局中的FittedBox、AspectRatio、ConstrainedBox,詳細介紹了其布舉行為以及使用場景,並對原始碼進行了分析。

1. FittedBox

Scales and positions its child within itself according to fit.

1.1 簡介

按照其官方的介紹,它主要做了兩件事情,縮放(Scale)以及位置調整(Position)。

FittedBox會在自己的尺寸範圍內縮放並且調整child位置,使得child適合其尺寸。做過移動端的,可能會聯想到ImageView控制元件,它是將圖片在其範圍內,按照規則,進行縮放位置調整。FittedBox跟ImageView是有些類似的,可以猜測出,它肯定有一個類似於ScaleType的屬性。

1.2 佈局行為

FittedBox的佈局行為還算簡單,官方沒有給出說明,我在這裡簡單說一下。由於FittedBox是一個容器,需要讓其child在其範圍內縮放,因此其佈局行為分兩種情況:

  • 如果外部有約束的話,按照外部約束調整自身尺寸,然後縮放調整child,按照指定的條件進行佈局;
  • 如果沒有外部約束條件,則跟child尺寸一致,指定的縮放以及位置屬性將不起作用。

1.3 繼承關係

Object > Diagnosticable > DiagnosticableTree > Widget > RenderObjectWidget > SingleChildRenderObjectWidget > FittedBox
複製程式碼

從繼承關係可以看出,FittedBox控制元件是一個基礎控制元件。

1.4 示例程式碼

new Container(
  color: Colors.amberAccent,
  width: 300.0,
  height: 300.0,
  child: new FittedBox(
    fit: BoxFit.contain,
    alignment: Alignment.topLeft,
    child: new Container(
      color: Colors.red,
      child: new Text("FittedBox"),
    ),
  ),
)
複製程式碼

寫了一個很簡單的例子,加入Container是為了加顏色顯示兩個區域,讀者可以試著修改fit以及alignment檢視其不同的效果。

1.5 原始碼解析

const FittedBox({
Key key,
this.fit: BoxFit.contain,
this.alignment: Alignment.center,
Widget child,
})
複製程式碼

1.5.1 屬性解析

fit:縮放的方式,預設的屬性是BoxFit.contain,child在FittedBox範圍內,儘可能的大,但是不超出其尺寸。這裡注意一點,contain是保持著child寬高比的大前提下,儘可能的填滿,一般情況下,寬度或者高度達到最大值時,就會停止縮放。

BoxFit佈局表現

alignment:對齊方式,預設的屬性是Alignment.center,居中顯示child。

1.5.2 原始碼

建構函式如下:

@override
RenderFittedBox createRenderObject(BuildContext context) {
return new RenderFittedBox(
  fit: fit,
  alignment: alignment,
  textDirection: Directionality.of(context),
);
}
複製程式碼

FittedBox具體實現是由RenderFittedBox進行的。不知道讀者有沒有發現,目前的一些基礎控制元件,繼承自RenderObjectWidget的,widget本身都只是儲存了一些配置資訊,真正的繪製渲染,則是由內部的createRenderObject所呼叫的RenderObject去實現的。

RenderFittedBox具體的佈局程式碼如下:

if (child != null) {
  child.layout(const BoxConstraints(), parentUsesSize: true);
  // 如果child不為null,則按照child的尺寸比率縮放child的尺寸
  size = constraints.constrainSizeAndAttemptToPreserveAspectRatio(child.size);
  _clearPaintData();
} else {
  // 如果child為null,則按照最小尺寸進行佈局
  size = constraints.smallest;
}
複製程式碼

1.6 使用場景

FittedBox在目前的專案中還未用到過。對於需要縮放調整位置處理的,一般都是圖片。筆者一般都是使用Container中的decoration屬性去實現相應的效果。對於其他控制元件需要縮放以及調整位置的,目前還沒有遇到使用場景,大家只需要知道有這麼一個控制元件,可以實現這個功能即可。

2. AspectRatio

A widget that attempts to size the child to a specific aspect ratio.

2.1 簡介

AspectRatio的作用是調整child到設定的寬高比,這種控制元件在其他移動端平臺上一般都不會提供,Flutter之所以提供,我想最大的原因,可能就是自定義起來特別麻煩吧。

2.2 佈局行為

AspectRatio的佈局行為分為兩種情況:

  • AspectRatio首先會在佈局限制條件允許的範圍內儘可能的擴充套件,widget的高度是由寬度和比率決定的,類似於BoxFit中的contain,按照固定比率去儘量佔滿區域。
  • 如果在滿足所有限制條件過後無法找到一個可行的尺寸,AspectRatio最終將會去優先適應佈局限制條件,而忽略所設定的比率。

2.3 繼承關係

Object > Diagnosticable > DiagnosticableTree > Widget > RenderObjectWidget > SingleChildRenderObjectWidget > AspectRatio
複製程式碼

從繼承關係看,AspectRatio是基礎的佈局控制元件。

2.4 示例程式碼

new Container(
  height: 200.0,
  child: new AspectRatio(
    aspectRatio: 1.5,
    child: new Container(
      color: Colors.red,
    ),
  ),
);
複製程式碼

示例程式碼是定義了一個高度為200的區域,內部AspectRatio比率設定為1.5,最終AspectRatio的是寬300高200的一個區域。

2.5 原始碼解析

建構函式如下:

const AspectRatio({
Key key,
@required this.aspectRatio,
Widget child
}) 
複製程式碼

建構函式只包含了一個aspectRatio屬性,其中aspectRatio不能為null。

2.5.1 屬性解析

aspectRatio:aspectRatio是寬高比,最終可能不會根據這個值去佈局,具體則要看綜合因素,外層是否允許按照這種比率進行佈局,只是一個參考值。

2.5.2 原始碼

@override
  RenderAspectRatio createRenderObject(BuildContext context) => new RenderAspectRatio(aspectRatio: aspectRatio);
複製程式碼

經過前面一些控制元件的解析,我想大家對這種構造應該不會再陌生了,繪製都是交由RenderObject去完成的,這裡則是由RenderAspectRatio去完成具體的繪製工作。

RenderAspectRatio的建構函式中會對aspectRatio做一些檢測(assert)

  • aspectRatio不能為null;
  • aspectRatio必須大於0;
  • aspectRatio必須是有限的。

接下來我們來看一下RenderAspectRatio的具體尺寸計算函式:

  • 如果限制條件為isTight,則返回最小的尺寸(constraints.smallest);
if (constraints.isTight)
  return constraints.smallest;
複製程式碼
  • 如果寬度為有限的值,則將高度設定為width / _aspectRatio。 如果寬度為無限,則將高度設為最大高度,寬度設為height * _aspectRatio;
if (width.isFinite) {
  height = width / _aspectRatio;
} else {
  height = constraints.maxHeight;
  width = height * _aspectRatio;
}
複製程式碼
  • 接下來則是在限制範圍內調整寬高,總體思想則是寬度優先,大於最大值則設為最大值,小於最小值,則設為最小值。

如果寬度大於最大寬度,則將其設為最大寬度,高度設為width / _aspectRatio;

if (width > constraints.maxWidth) {
  width = constraints.maxWidth;
  height = width / _aspectRatio;
}
複製程式碼

如果高度大於最大高度,則將其設為最大高度,寬度設為height * _aspectRatio;

if (height > constraints.maxHeight) {
  height = constraints.maxHeight;
  width = height * _aspectRatio;
}
複製程式碼

如果寬度小於最小寬度,則將其設為最小寬度,高度設為width / _aspectRatio;

if (width < constraints.minWidth) {
  width = constraints.minWidth;
  height = width / _aspectRatio;
}
複製程式碼

如果高度小於最小高度,則將其設為最小高度,寬度設為height * _aspectRatio。

if (height < constraints.minHeight) {
  height = constraints.minHeight;
  width = height * _aspectRatio;
}
複製程式碼

2.6 使用場景

AspectRatio適用於需要固定寬高比的情景下。筆者最近使用這個控制元件的場景是相機,相機的預覽尺寸都是固定的幾個值,因此不能隨意去設定相機的顯示區域,必須按照比率進行顯示,否則會出現拉伸的情況。除此之外,倒是用的不多。

3. ConstrainedBox

A widget that imposes additional constraints on its child.

3.1 簡介

這個控制元件的作用是新增額外的限制條件(constraints)到child上,本身挺簡單的,可以被一些控制元件替換使用。Flutter的佈局控制元件體系,梳理著發現確實有點亂,感覺總體思想是缺啥就造啥,哈哈。

3.2 佈局行為

ConstrainedBox的佈局行為非常簡單,取決於設定的限制條件,而關於父子節點的限制因素生效優先順序,可以檢視之前的文章,在這裡就不做具體敘述了。

3.3 繼承關係

Object > Diagnosticable > DiagnosticableTree > Widget > RenderObjectWidget > SingleChildRenderObjectWidget > ConstrainedBox
複製程式碼

ConstrainedBox也是一個基礎的佈局控制元件。

3.4 示例程式碼

new ConstrainedBox(
  constraints: const BoxConstraints(
    minWidth: 100.0,
    minHeight: 100.0,
    maxWidth: 150.0,
    maxHeight: 150.0,
  ),
  child: new Container(
    width: 200.0,
    height: 200.0,
    color: Colors.red,
  ),
);
複製程式碼

例子也挺簡單的,在一個寬高200.0的Container上新增一個約束最大最小寬高的ConstrainedBox,實際的顯示中,則是一個寬高為150.0的區域。

3.5 原始碼解析

建構函式如下:

ConstrainedBox({
Key key,
@required this.constraints,
Widget child
})
複製程式碼

包含了一個constraints屬性,且不能為null。

3.5.1 屬性解析

constraints:新增到child上的額外限制條件,其型別為BoxConstraints。BoxConstraints的作用是幹啥的呢?其實很簡單,就是限制各種最大最小寬高。說到這裡插一句,double.infinity在widget佈局的時候是合法的,也就說,例如想最大的擴充套件寬度,可以將寬度值設為double.infinity。

3.5.2 原始碼

@override
RenderConstrainedBox createRenderObject(BuildContext context) {
return new RenderConstrainedBox(additionalConstraints: constraints);
}
複製程式碼

RenderConstrainedBox實現其繪製。其具體的佈局表現分兩種情況:

  • 如果child不為null,則將限制條件加在child上;
  • 如果child為null,則會盡可能的縮小尺寸。

具體程式碼如下:

@override
void performLayout() {
if (child != null) {
  child.layout(_additionalConstraints.enforce(constraints), parentUsesSize: true);
  size = child.size;
} else {
  size = _additionalConstraints.enforce(constraints).constrain(Size.zero);
}
}
複製程式碼

3.6 使用場景

需要新增額外的約束條件可以使用此控制元件,例如設定最小寬高,儘可能的佔用區域等等。筆者在實際開發中使用的倒不是很多,倒不是說這個控制元件不好使用,而是好多約束因素是綜合的,例如需要額外的設定margin、padding屬效能,因此單獨再套個這個就顯得很繁瑣了。

3.7 關於UnconstrainedBox

這個控制元件不做詳細介紹了,它跟ConstrainedBox相反,是不新增任何約束條件到child上,讓child按照其原始的尺寸渲染。

很神奇是吧,我也覺得,其實它的作用就是給child一個儘可能大的空間,不加約束的讓其顯示。用處我暫時木有想到。只能說Flutter生產Widget很隨性。

4. 後話

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

5. 參考

  1. FittedBox class
  2. BoxFit enum
  3. AspectRatio class
  4. ConstrainedBox class
  5. BoxConstraints class
  6. UnconstrainedBox class

相關文章