Android中DialogFragment首次显示时EditText软键盘自动隐藏问题

我之前也踩过这个一模一样的坑！明明给EditText设置了焦点，也手动调用了弹出软键盘的方法，但DialogFragment显示时软键盘就是藏着不出来，非得点一下输入框才行，太影响用户体验了。

问题根源 #

这本质上是DialogFragment的视图布局时机和系统软键盘触发时机不匹配导致的：当我们尝试唤起软键盘时，Dialog的布局可能还没完全完成，系统找不到正确的焦点视图，自然就弹不出键盘；等布局完成后，系统也不会再自动触发键盘弹出了。

解决方案：用ViewTreeObserver监听布局完成 #

你提到的ViewTreeObserver方案确实是最靠谱的解决办法，核心就是等Dialog的视图树完全布局完成后，再去触发软键盘弹出。下面是完整的可运行代码：

// 在你的DialogFragment的onCreateView方法中获取EditText
EditText editText = view.findViewById(R.id.your_edit_text_id);

// 请求焦点
editText.requestFocus();

// 添加视图树布局完成监听
editText.getViewTreeObserver().addOnGlobalLayoutListener(new ViewTreeObserver.OnGlobalLayoutListener() {
    @Override
    public void onGlobalLayout() {
        // 先移除监听，避免重复触发
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.JELLY_BEAN) {
            editText.getViewTreeObserver().removeOnGlobalLayoutListener(this);
        } else {
            // 兼容低版本API
            editText.getViewTreeObserver().removeGlobalOnLayoutListener(this);
        }

        // 触发软键盘弹出
        InputMethodManager imm = (InputMethodManager) requireContext().getSystemService(Context.INPUT_METHOD_SERVICE);
        imm.showSoftInput(editText, InputMethodManager.SHOW_IMPLICIT);
    }
});

额外的优化建议 #

• 在EditText的XML布局中提前设置可聚焦属性，确保焦点能正常获取：

  <EditText
      ...
      android:focusable="true"
      android:focusableInTouchMode="true"/>
  

• 可以在DialogFragment的onStart()方法中设置Dialog的输入法模式，进一步强制软键盘弹出：

  @Override
  public void onStart() {
      super.onStart();
      if (getDialog() != null) {
          getDialog().getWindow().setSoftInputMode(WindowManager.LayoutParams.SOFT_INPUT_STATE_ALWAYS_VISIBLE);
      }
  }
  

这样组合下来，基本就能保证DialogFragment显示时，软键盘会自动弹出来，不用用户手动点击输入框啦！

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