使用全新 TabBar.tabAlignment 屬性自訂分頁標籤（Tabs）對齊方式

使用 TabBar.tabAlignment 來自訂 TabBar 中分頁標籤（Tabs）的對齊方式。

TabBar.tabAlignment 屬性用於設定 Material 3 TabBar 中分頁標籤的擺放位置。 TabAlignment 列舉（enum）包含以下幾個值：

• TabAlignment.start：將分頁標籤對齊至可捲動 TabBar 的起始位置。
• TabAlignment.startOffset：將分頁標籤對齊至可捲動 TabBar 的起始位置，並有 52.0 像素的偏移量。
• TabAlignment.center：將分頁標籤對齊至 TabBar 的中央。
• TabAlignment.fill：將分頁標籤對齊至起始位置，並將分頁標籤拉伸以填滿固定寬度的 TabBar。

可捲動的 TabBar 支援以下對齊方式：

• TabAlignment.start
• TabAlignment.startOffset
• TabAlignment.center

固定寬度的 TabBar 支援以下對齊方式：

• TabAlignment.fill
• TabAlignment.center

當你將 ThemeData.useMaterial3 設為 true 時， 可捲動的 TabBar 預設會將分頁標籤對齊為 TabAlignment.startOffset。 若要變更此對齊方式，請設定 TabBar.tabAlignment 屬性以進行元件 (Widget) 層級的自訂。 或者，設定 TabBarThemeData.tabAlignment 屬性以進行應用程式層級的自訂。

當你將 TabBar.isScrollable 和 ThemeData.useMaterial3 設為 true 時， 可捲動的 TabBar 中的分頁標籤預設會採用 TabAlignment.startOffset。 這會將分頁標籤對齊至可捲動 TabBar 的起始位置，並有 52.0 像素的偏移量。 這項行為與先前不同。 過去當分頁標籤數量超過可顯示寬度時，會將分頁標籤對齊至可捲動 TabBar 的起始位置。

Material 3 的可捲動 TabBar 預設使用 TabAlignment.startOffset 作為 分頁標籤的對齊方式。 這會將分頁標籤對齊至可捲動 TabBar 的起始位置，並有 52.0 像素的偏移量。

若要將分頁標籤對齊至可捲動 TabBar 的起始位置，請將 TabBar.tabAlignment 設為 TabAlignment.start。 此變更同時會移除 52.0 像素的偏移量。 以下程式碼片段展示如何使用 TabBar.tabAlignment 將分頁標籤對齊至可捲動 TabBar 的起始位置：

遷移前的程式碼：

TabBar(
  isScrollable: true,
  tabs: List<Tab>.generate(
    count,
    (int index) => Tab(text: 'Tab $index'),
  ).toList(),
);

遷移後的程式碼：

TabBar(
  tabAlignment: TabAlignment.start,
  isScrollable: true,
  tabs: List<Tab>.generate(
    count,
    (int index) => Tab(text: 'Tab $index'),
  ).toList(),
);

合併於版本：3.13.0-17.0.pre
穩定版釋出：3.16

API 文件：

• TabBar
• TabBar.tabAlignment
• TabAlignment

相關 PR：

• Introduce TabBar.tabAlignment
• Fix Material 3 Scrollable TabBar