# 已淘汰的 ExpansionTileController

> `ExpansionTileController` 已被淘汰，並由 `ExpansibleController` 取代。





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

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


## 摘要

`ExpansionTileController` 已被淘汰。相同的功能現在可以透過 `ExpansibleController` 來實現。

## 背景

`ExpansionTileController` 可用於以程式方式展開與收合 `ExpansionTile`。元件 (Widget) 函式庫中新增了一個新的 `Expansible` 元件，其包含展開與收合的邏輯，且不再綁定於 Material 函式庫。`ExpansibleController` 補足了 `Expansible`，並且擁有與 `ExpansionTileController` 相同的功能。此外，`ExpansibleController` 也支援在展開狀態 (state) 變更時新增與通知監聽器。

當應用程式在 debug 模式下使用 `ExpansionTileController` 時，會顯示以下錯誤訊息：「請改用 `ExpansibleController`。」。具體來說，這表示使用者應將 `ExpansionTileController` 的用法替換為 `ExpansibleController`。

## 遷移指南

要進行遷移，請將 `ExpansionTile` 的 `controller` 參數，從 `ExpansionTileController` 替換為 `ExpansibleController`。與 `ExpansionTileController` 不同，`ExpansibleController` 是一個 `ChangeNotifier`，因此請記得在不需要時釋放（dispose）新的 `ExpansibleController`。

遷移前的程式碼：

```dart
class _MyWidgetState extends State<MyWidget> {
  final ExpansionTileController controller = ExpansionTileController();

  @override
  Widget build(BuildContext context) {
    return ExpansionTile(
      controller: controller,
    );
  }
}
```

遷移後的程式碼：

```dart
class _MyWidgetState extends State<MyWidget> {
  final ExpansibleController controller = ExpansibleController();

  @override
  void dispose() {
    controller.dispose();
    super.dispose();
  }

  @override
  Widget build(BuildContext context) {
    return ExpansionTile(
      controller: controller,
    );
  }
}
```

## 時程

合併於版本：3.31.0-0.1.pre<br>
正式版發佈於：3.32

## 參考資料

API 文件：

* [`ExpansionTileController`][]
* [`ExpansibleController`][]
* [`ExpansionTile.controller`][]
* [`Expansible.controller`][]

相關議題：

* [ExpansionTile 與其 Cupertino 變體的程式碼共用][Codeshare between ExpansionTile and its Cupertino variant]
* [棄用 ExpansionTileController，改用 ExpansibleController][Deprecate ExpansionTileController in favor of ExpansibleController]

相關 PR：

* [引入 Expansible，作為 ExpansionTile 的基礎元件][Introduce Expansible, a base widget for ExpansionTile]
* [棄用 ExpansionTileController][Deprecate ExpansionTileController]

[`ExpansionTileController`]: https://pub.dev/documentation/material_ui/latest/material_ui/ExpansionTileController-class.html
[`ExpansibleController`]: https://api.flutter.dev/flutter/widgets/ExpansibleController-class.html
[`ExpansionTile.controller`]: https://pub.dev/documentation/material_ui/latest/material_ui/ExpansionTile/controller.html
[`Expansible.controller`]: https://api.flutter.dev/flutter/widgets/Expansible/controller.html

[Codeshare between ExpansionTile and its Cupertino variant]: https://github.com/flutter/flutter/issues/163552
[Deprecate ExpansionTileController in favor of ExpansibleController]: https://github.com/flutter/flutter/issues/165511
[Introduce Expansible, a base widget for ExpansionTile]: https://github.com/flutter/flutter/pull/164049
[Deprecate ExpansionTileController]: https://github.com/flutter/flutter/pull/166368