DialogFragment中软键盘显示及关闭（含对话框关闭）的异常问题解决

一、自动弹出软键盘失效的修复 #

你的onResume中调用showSoftInput时机过早，Dialog视图尚未完全完成布局，或输入框未成功获取焦点，可通过以下两种方案修复：

方案1：延迟请求+强制获取焦点 #

修改showKeyboard方法，先让输入框获取焦点，再通过post延迟确保视图布局完成后调用软键盘：

private fun showKeyboard() {
    val editText = view?.findViewById<EditText>(R.id.quantity) ?: return
    // 强制输入框获取焦点
    editText.requestFocus()
    val inputMethodManager = activity?.getSystemService(Context.INPUT_METHOD_SERVICE) as InputMethodManager
    // 延迟执行，确保Dialog视图布局完成
    editText.post {
        inputMethodManager.showSoftInput(editText, InputMethodManager.SHOW_IMPLICIT)
    }
}

方案2：配置Dialog的Window属性 #

在Dialog创建时直接设置Window软键盘模式，让对话框显示时自动弹出键盘：

override fun onCreateDialog(savedInstanceState: Bundle?): Dialog {
    val dialog = super.onCreateDialog(savedInstanceState)
    dialog.window?.apply {
        // 设置对话框显示时自动弹出软键盘
        setSoftInputMode(WindowManager.LayoutParams.SOFT_INPUT_STATE_ALWAYS_VISIBLE)
    }
    return dialog
}

二、关闭对话框时软键盘未隐藏的修复 #

onDestroy调用时机太晚，此时Dialog视图已销毁，view?.windowToken为空，需在对话框关闭前触发键盘隐藏：

1. 完善关闭键盘的方法 #

增加空安全判断，避免空指针异常：

private fun closeKeyboard() {
    val view = view ?: return
    val inputMethodManager = activity?.getSystemService(Context.INPUT_METHOD_SERVICE) as? InputMethodManager ?: return
    inputMethodManager.hideSoftInputFromWindow(view.windowToken, 0)
}

2. 在合适时机调用关闭方法 #

• 重写onDismiss：对话框关闭时触发键盘隐藏

override fun onDismiss(dialog: DialogInterface) {
    super.onDismiss(dialog)
    closeKeyboard()
}

• 监听输入框完成键：给EditText配置imeOptions并添加监听
  布局文件中配置EditText：

<EditText
    android:id="@+id/quantity"
    android:imeOptions="actionDone"
    android:inputType="text" />

代码中添加完成键监听：

override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
    super.onViewCreated(view, savedInstanceState)
    val editText = view.findViewById<EditText>(R.id.quantity)
    editText.setOnEditorActionListener { _, actionId, _ ->
        if (actionId == EditorInfo.IME_ACTION_DONE) {
            closeKeyboard()
            return@setOnEditorActionListener true
        }
        false
    }
}

• 确定按钮点击时触发：如果对话框有确定按钮，点击时先关闭键盘再关闭对话框

// 假设确定按钮id为btn_confirm
view.findViewById<Button>(R.id.btn_confirm).setOnClickListener {
    closeKeyboard()
    dismiss()
}

完整代码示例 #

class CustomInputDialog : DialogFragment() {

    override fun onCreateDialog(savedInstanceState: Bundle?): Dialog {
        val dialog = AlertDialog.Builder(requireContext())
            .setView(R.layout.dialog_input)
            .setPositiveButton("确定") { _, _ -> }
            .create()
        
        // 设置自动弹出软键盘
        dialog.window?.setSoftInputMode(WindowManager.LayoutParams.SOFT_INPUT_STATE_ALWAYS_VISIBLE)
        return dialog
    }

    override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
        super.onViewCreated(view, savedInstanceState)
        val editText = view.findViewById<EditText>(R.id.quantity)
        
        // 监听输入框完成键
        editText.setOnEditorActionListener { _, actionId, _ ->
            if (actionId == EditorInfo.IME_ACTION_DONE) {
                closeKeyboard()
                return@setOnEditorActionListener true
            }
            false
        }

        // 重写确定按钮逻辑
        (dialog as AlertDialog).getButton(AlertDialog.BUTTON_POSITIVE).setOnClickListener {
            closeKeyboard()
            dismiss()
            // 这里添加确定后的业务逻辑
        }
    }

    private fun closeKeyboard() {
        val view = view ?: return
        val inputMethodManager = requireContext().getSystemService(Context.INPUT_METHOD_SERVICE) as InputMethodManager
        inputMethodManager.hideSoftInputFromWindow(view.windowToken, 0)
    }

    override fun onDismiss(dialog: DialogInterface) {
        super.onDismiss(dialog)
        closeKeyboard()
    }
}

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