Một màn hình có dữ liệu chưa lưu cần kiểm soát thao tác quay lại. PopScope cung cấp canPop để mô tả khả năng rời route và callback để báo kết quả một lần pop được thử. Nếu callback tiếp tục pop mà không đọc didPop, logic có thể rời thêm route sau khi thao tác đầu đã thành công.
Đọc callback như một kết quả
Ví dụ bọc nội dung trong một route đã được push lên Navigator. canLeave là trạng thái do màn hình quản lý. Khi didPop bằng true, route đã được pop nên callback kết thúc. Khi bị chặn, ví dụ hiện thông báo thay vì tự thay đổi stack.
import 'package:flutter/material.dart';
class GuardedPage extends StatelessWidget {
const GuardedPage({super.key, required this.canLeave});
final bool canLeave;
@override
Widget build(BuildContext context) {
return PopScope<void>(
canPop: canLeave,
onPopInvokedWithResult: (didPop, result) {
if (didPop) return;
ScaffoldMessenger.of(context).showSnackBar(
const SnackBar(content: Text('Hãy lưu trước khi quay lại')),
);
},
child: const Scaffold(
body: Center(child: Text('Nội dung đang chỉnh sửa')),
),
);
}
}
Kiểm tra trên route có màn hình trước
Đặt một nút ở màn hình trước để push GuardedPage. Khi canLeave false, thử nút back và thao tác back hệ thống. Trên Android, callback có thể báo lần thử bị chặn. Với một số gesture iOS khi canPop false, gesture không được nhận diện để báo callback. Vì vậy, thông báo của ví dụ không nên là hướng dẫn duy nhất cho người dùng.
Sau khi lưu dữ liệu, cập nhật trạng thái cha để canLeave true. Lặp thao tác và xác nhận chỉ quay về một màn hình. Kiểm tra cả nút back trên thanh điều hướng nếu ứng dụng tùy biến nút đó.
Chọn generic và quản lý trạng thái
Generic của PopScope cần phù hợp với kiểu kết quả của route. Ví dụ dùng void cho route không trả dữ liệu. Nếu route trả một kết quả có kiểu, giữ kiểu đó nhất quán trong khai báo và lệnh điều hướng.
Khi thêm hộp thoại xác nhận bất đồng bộ, ngăn mở nhiều hộp thoại do nhiều lần bấm và kiểm tra mounted sau await trước khi thao tác context. Chốt trạng thái canPop và thời điểm gọi Navigator theo cùng một luồng để tránh callback lặp.
Đối chiếu API của Flutter dự án trước khi dùng onPopInvokedWithResult. Ví dụ được rà theo tài liệu hiện tại ngày 20/11/2026, chưa build với SDK hoặc chạy trên thiết bị trong lượt này. Hành vi gesture cần được kiểm tra trên cả nền tảng mà sản phẩm hỗ trợ.

