Flutter中AlertDialog内TextField与PopupMenuButton定位异常求助

问题原因 #

TextField获取焦点触发键盘弹出后，AlertDialog会自动上浮适配键盘空间；此时点击PopupMenuButton会导致TextField失焦，键盘收起的Dialog下沉动画与PopupMenu的展开动画同时执行，菜单计算位置时基于Dialog的中间状态，最终出现位置偏移。

解决方案：延迟PopupMenu弹出时机 #

通过SchedulerBinding等待UI帧更新完成（即Dialog完成重定位）后再弹出菜单，避免两个动画冲突。

实现步骤：

1. 给TextField绑定FocusNode，用于手动控制焦点；给PopupMenuButton绑定GlobalKey，用于获取按钮的位置信息。
2. 禁用PopupMenuButton的默认弹出逻辑，自定义onTap事件：先移除TextField焦点并收起键盘，再通过addPostFrameCallback延迟执行弹出菜单的逻辑。

完整代码示例：

import 'package:flutter/material.dart';
import 'package:flutter/scheduler.dart';

class FixedDialogMenu extends StatelessWidget {
  final FocusNode _textFieldFocus = FocusNode();
  final GlobalKey _menuKey = GlobalKey();

  void _showCustomMenu(BuildContext context) {
    // 手动移除TextField焦点并收起键盘
    _textFieldFocus.unfocus();
    
    // 获取PopupMenuButton的屏幕位置
    final RenderBox button = _menuKey.currentContext!.findRenderObject() as RenderBox;
    final RenderBox overlay = Overlay.of(context).context.findRenderObject() as RenderBox;
    final RelativeRect menuPosition = RelativeRect.fromRect(
      Rect.fromPoints(
        button.localToGlobal(Offset.zero, ancestor: overlay),
        button.localToGlobal(button.size.bottomRight(Offset.zero), ancestor: overlay),
      ),
      Offset.zero & overlay.size,
    );

    // 等待Dialog完成重定位后弹出菜单
    SchedulerBinding.instance.addPostFrameCallback((_) {
      showMenu(
        context: context,
        position: menuPosition,
        items: const [
          PopupMenuItem(child: Text('123')),
          PopupMenuItem(child: Text('456')),
        ],
      );
    });
  }

  @override
  Widget build(BuildContext context) {
    return AlertDialog(
      content: Column(
        mainAxisSize: MainAxisSize.min,
        children: [
          TextField(focusNode: _textFieldFocus),
          PopupMenuButton(
            key: _menuKey,
            onTap: () => _showCustomMenu(context),
            icon: const Icon(Icons.more_vert),
            // 禁用默认itemBuilder逻辑，改用自定义showMenu
            itemBuilder: (_) => [],
          )
        ],
      ),
    );
  }
}

其他可选方案 #

• 固定Dialog位置：给AlertDialog设置固定的insetPadding，禁用其随键盘自动上浮/下沉的特性，但会牺牲自适应布局的体验。
• 监听焦点变化：通过FocusManager监听TextField的焦点移除事件，在事件回调中延迟弹出菜单，逻辑与上述方案一致。

内容的提问来源于stack exchange，提问作者Toonj