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

過去，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。

遷移前的程式碼：

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

遷移後的程式碼：

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

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

API 文件：

• Form

相關議題：

• Issue 161628

相關 PR：

• PR 170709: Add semantics role for form