# Form 元件不再支援作為 sliver 使用

> Form 元件現在內建了一個 semantics 元件， 這會阻止它被直接作為 sliver 使用。




:::important
這些重大變更文件在其發布的版本時是準確的。隨著時間推移，這裡描述的
因應措施可能會變得不準確。一般而言，我們不會在每個版本發布時同步更新這些重大變更文件。

[重大變更索引檔案](/release/breaking-changes)列出了每個版本所建立的文件。
:::


## 摘要

過去，Form 元件本質上只是直接包裹其子元件。這種設計允許包含 sliver 子元件的 Form
（例如：`Form(child: other sliver)`）在 `CustomScrollView` 或其他類似可滾動父元件中
被當作 sliver 使用。

然而，此 PR 在 Form 元件的內部結構中新增了一個 semantics 元件。
這項變更改變了其渲染行為，意味著 Form 不再能直接作為 sliver 運作。

## 背景

這項變更是為了持續提升 Flutter 元件的無障礙性與語意理解。
透過在 Form 內嵌入 semantics 元件，框架能夠向無障礙服務提供更完善的資訊。

## 變更說明

核心變更是在 Form 元件的 build 方法中整合了一個 semantics 元件。

## 遷移指南

如果你的應用程式目前沒有直接將 Form 元件當作 sliver
（例如：作為 `CustomScrollView` 的 `slivers` 屬性的直接子元件）使用，
則無需進行任何更動。

如果你的應用程式有將 Form 作為 sliver 使用，則需要將 Form 元件包裹在 `SliverToBoxAdapter` 中。
`SliverToBoxAdapter` 是一個可包含單一 box 元件的 sliver，能將一般元件轉換為可放入 `CustomScrollView` 的 sliver。

遷移前的程式碼：

```dart
sliver: Form(
    key: controller.formKey,
    child: SomeWidgetWithFormFields(),
)
```

遷移後的程式碼：

```dart
sliver: SliverToBoxAdapter(
    child: Form(
        key: controller.formKey,
        child: SomeWidgetWithFormFields(),
    )
)
```

## 時程

合併於版本：3.35.0-pre<br>
正式版本發佈於：3.35

## 參考資料

API 文件：

* [`Form`](https://api.flutter.dev/flutter/widgets/Form-class.html)

相關議題：

* [Issue 161628](https://github.com/flutter/flutter/issues/161628)

相關 PR：

* [PR 170709: Add semantics role for form](https://github.com/flutter/flutter/pull/170709)