PDF预览

✅ 方案一（强烈推荐）：全局 NavigatorObserver（最干净）
🧠 为什么这是「最佳实践」
✅ 方案二：RouteObserver + 页面混入（适合精细控制）
- 1️⃣ 定义 RouteObserver
- 2️⃣ 页面里监听「返回到当前页面」
🟡 方案三（兜底）：全局 WidgetsBindingObserver
🧩 回到你的例子（TestHome）
🧠 一句话总结（建议你记住）
🚀 如果你愿意继续进阶

这是一个非常典型、而且你现在已经走到「架构层」的问题 👍
你问的是：

如何统一、全局地实现：页面返回（pop）时自动 unfocus（取消光标 & 键盘）

答案是：
👉 用 NavigatorObserver / RouteObserver 在路由层统一处理
而不是在每个页面、每个 TextField 手动写。

下面我给你 3 种方案，从“最推荐”到“兜底”，并告诉你为什么选它。

✅ 方案一（强烈推荐）：全局 `NavigatorObserver`（最干净）

原理一句话

只要发生 pop（返回），统一调用：

FocusManager.instance.primaryFocus?.unfocus();

1️⃣ 定义一个全局 Observer

class UnfocusOnPopObserver extends NavigatorObserver {
void _unfocus() {
FocusManager.instance.primaryFocus?.unfocus();
}

@override
void didPop(Route route, Route? previousRoute) {
_unfocus();
super.didPop(route, previousRoute);
}

@override
void didPush(Route route, Route? previousRoute) {
// 可选：push 时也 unfocus（防止闪键盘）
_unfocus();
super.didPush(route, previousRoute);
}

@override
void didReplace({Route? newRoute, Route? oldRoute}) {
_unfocus();
super.didReplace(newRoute: newRoute, oldRoute: oldRoute);
}
}

2️⃣ 在 `MaterialApp` 里注册（关键）

MaterialApp(
navigatorObservers: [
UnfocusOnPopObserver(),
],
home: const HomePage(),
);

🎉 效果

✅ 所有 Navigator.push / pop / replace
✅ 所有页面
✅ 所有 TextField
✅ 包括你这个 TestHome

完全不用改你写的任何页面代码

🧠 为什么这是「最佳实践」

方式	是否推荐	原因
push 前手动 unfocus	❌	容易忘
每个页面 dispose	❌	太分散
WillPopScope	⚠️	只能处理 back
NavigatorObserver	✅✅✅	路由层统一处理

👉 键盘是全局 UI 状态，就应该在路由层处理

✅ 方案二：RouteObserver + 页面混入（适合精细控制）

如果你希望：

只有部分页面
或只在 didPopNext（返回到该页面）时 unfocus

1️⃣ 定义 RouteObserver

final RouteObserver<PageRoute> routeObserver =
RouteObserver<PageRoute>();

MaterialApp(
navigatorObservers: [routeObserver],
);

2️⃣ 页面里监听「返回到当前页面」

class _HomeState extends State<Home>
with RouteAware {

@override
void didChangeDependencies() {
super.didChangeDependencies();
routeObserver.subscribe(
this,
ModalRoute.of(context)! as PageRoute,
);
}

@override
void didPopNext() {
FocusManager.instance.primaryFocus?.unfocus();
}

@override
void dispose() {
routeObserver.unsubscribe(this);
super.dispose();
}
}

📌 适合：

聊天页
搜索页
编辑页

但不如方案一简单统一

🟡 方案三（兜底）：全局 `WidgetsBindingObserver`

class GlobalUnfocusObserver with WidgetsBindingObserver {
@override
void didChangeAppLifecycleState(AppLifecycleState state) {
if (state == AppLifecycleState.resumed) {
FocusManager.instance.primaryFocus?.unfocus();
}
}
}

📌 只能处理：

后台 → 前台
不是真正的路由 pop

⚠️ 不推荐作为主方案

🧩 回到你的例子（TestHome）

你原来的代码：

await Navigator.of(context).push(
MaterialPageRoute(builder: (_) => TestHome()),
);

👉 完全不用改

只要在 MaterialApp 里加：

navigatorObservers: [
UnfocusOnPopObserver(),
],

你现在的行为会变成：

TextField 有光标
push 到 TestHome
pop 返回
🔥 键盘不弹，光标消失

🧠 一句话总结（建议你记住）

键盘 / Focus 是全局状态
路由切换是全局事件
👉 用 NavigatorObserver 统一处理

🚀 如果你愿意继续进阶

我可以帮你：

🔹 做一个 AppNavigatorObserver（顺带统计路由）
🔹 适配 GoRouter / AutoRoute
🔹 处理 Android 13 predictive back
🔹 Drawer / BottomSheet / Dialog 全覆盖

直接告诉我你用的是哪套路由（Navigator 1.0 / GoRouter）即可。

✅ 方案一（强烈推荐）：全局 NavigatorObserver（最干净）