新增預測返回(predictive back)手勢
瞭解如何在 Flutter 中啟用並處理 Android 預測返回(predictive back)手勢。
Android 預測返回(predictive back)手勢讓使用者在確認或取消返回手勢之前, 可以預覽返回後將前往的位置, 無論是上一個畫面還是主畫面。
概覽
#從 Android 14(API level 34)開始, 當應用程式支援時, 系統手勢的預測返回動畫預設為啟用。 Flutter 針對預設的頁面 Route 轉場與自訂的 pop 處理, 內建支援預測返回動畫。
在 Android 中啟用預測返回
#若要在 Android 13 或更新版本上, 讓你的 Flutter 應用程式支援預測返回手勢:
- 開啟
android/app/src/main/AndroidManifest.xml。 - 將
android:enableOnBackInvokedCallback="true"加入<application>標籤:
<manifest xmlns:android="http://schemas.android.com/apk/res/android">
<application
android:label="my_app"
android:name="${applicationName}"
android:icon="@mipmap/ic_launcher"
android:enableOnBackInvokedCallback="true">
<!-- ... -->
</application>
</manifest>
使用 PopScope 處理返回手勢
#
若要自訂返回導覽,或避免使用者
不小心離開某個畫面,
請使用 PopScope
元件 (Widget)。
PopScope 取代了已棄用的 WillPopScope 元件,
並支援預測返回手勢。
回呼(callback)參數
#PopScope 使用 onPopInvokedWithResult 回呼:
-
didPop:布林值,表示 pop 操作是否成功。 如果canPop為false,則didPop為false。 -
result:在 pop Route 時傳入的選用回傳內容 (例如使用Navigator.pop(context, result))。
範例:攔截返回導覽
#PopScope(
canPop: false,
onPopInvokedWithResult: (bool didPop, Object? result) async {
if (didPop) {
return;
}
final shouldLeave = await _showExitConfirmationDialog(context);
if (shouldLeave && context.mounted) {
Navigator.of(context).pop(result);
}
},
child: Scaffold(
appBar: AppBar(title: const Text('Form Screen')),
body: const Center(child: Text('Complete the form before leaving.')),
),
)
更多資訊
#若想瞭解 API 遷移的更多細節, 請參閱 Android 預測返回遷移指南。
Unless stated otherwise, the documentation on this site reflects Flutter 3.47. Page last updated on 2026-10-25. View source or report an issue.