PopScope 的泛型型別

為 PopScope 類別新增了泛型型別，並將 onPopInvoked 替換為新的方法 onPopInvokedWithResult。 新方法接受一個布林值 didPop 和一個 result 作為位置參數。

同時也將 Form.onPopInvoked 替換為 Form.onPopInvokedWithResult， 原因相同。

過去，PopScope 在呼叫 onPopInvoked 時 無法取得 pop 的結果。 現在於 PopScope 類別中新增了泛型型別， 讓新方法 onPopInvokedWithResult 能夠存取型別安全的結果。

為 PopScope 類別新增了泛型型別（<T>），並 新增了一個新方法 onPopInvokedWithResult。 onPopInvoked 屬性已被棄用，建議改用 onPopInvokedWithResult。

同時也在 Form 中新增了新方法 onPopInvokedWithResult， 以取代 onPopInvoked。

遷移前的程式碼：

import 'package:flutter/material.dart';
​
void main() {
  runApp(
    MaterialApp(
      navigatorKey: nav,
      home: Column(
        children: [
          Form(
            canPop: false,
            onPopInvoked: (bool didPop) {
              if (didPop) {
                return;
              }
              launchConfirmationDialog();
            },
            child: MyWidget(),
          ),
          PopScope(
            canPop: false,
            onPopInvoked: (bool didPop) {
              if (didPop) {
                return;
              }
              launchConfirmationDialog();
            },
            child: MyWidget(),
          ),
        ],
      ),
    ),
  );
}

遷移後的程式碼：

import 'package:flutter/material.dart';
​
void main() {
  runApp(
    MaterialApp(
      navigatorKey: nav,
      home: Column(
        children: [
          Form(
            canPop: false,
            onPopInvokedWithResult: (bool didPop, Object? result) {
              if (didPop) {
                return;
              }
              launchConfirmationDialog();
            },
            child: MyWidget(),
          ),
          PopScope<Object?>(
            canPop: false,
            onPopInvokedWithResult: (bool didPop, Object? result) {
              if (didPop) {
                return;
              }
              launchConfirmationDialog();
            },
            child: MyWidget(),
          ),
        ],
      ),
    ),
  );
}

泛型型別應與 Route 所在的 PopScope 的泛型型別一致。 例如，如果該路由（Route）使用 int 作為其泛型型別， 建議使用 PopScope<int>。

如果 PopScope 元件 (Widget) 在多個具有不同型別的路由（Route）間共用， 可以使用 PopScope<Object?> 來涵蓋所有可能的型別。

合併於版本：3.22.0-26.0.pre
穩定版釋出：3.24.0

API 文件：

• PopScope
• onPopInvoked
• Route
• onPopInvokedWithResult
• Form.onPopInvoked
• Form.onPopInvokedWithResult

相關議題：

• Issue 137458

相關 PR：

• Add generic type for result in PopScope (已回滾)
• Reapply new PopScope API (最終重新合併)