Android软键盘的编程式隐藏方法

技术背景

在Android应用开发中，经常会遇到需要在特定操作后隐藏软键盘的需求。例如，在用户完成输入并点击按钮后，或者在触摸屏幕其他区域时，隐藏软键盘可以提升用户体验。然而，由于Android系统的复杂性，隐藏软键盘并非总是一帆风顺，不同的场景和系统版本可能需要不同的处理方法。

实现步骤

1. 使用InputMethodManager

这是最常见的方法，通过获取系统的InputMethodManager服务，调用hideSoftInputFromWindow方法来隐藏软键盘。

// Check if no view has focus:
View view = this.getCurrentFocus();
if (view != null) {  
    InputMethodManager imm = (InputMethodManager)getSystemService(Context.INPUT_METHOD_SERVICE);
    imm.hideSoftInputFromWindow(view.getWindowToken(), 0);
}

2. 封装为静态工具方法

为了方便在不同的Activity中使用，可以将上述代码封装为静态工具方法。

public static void hideKeyboard(Activity activity) {
    InputMethodManager imm = (InputMethodManager) activity.getSystemService(Activity.INPUT_METHOD_SERVICE);
    //Find the currently focused view, so we can grab the correct window token from it.
    View view = activity.getCurrentFocus();
    //If no view currently has focus, create a new one, just so we can grab a window token from it
    if (view == null) {
        view = new View(activity);
    }
    imm.hideSoftInputFromWindow(view.getWindowToken(), 0);
}

3. 在Fragment中隐藏软键盘

如果需要在Fragment中隐藏软键盘，可以使用以下方法。

public static void hideKeyboardFrom(Context context, View view) {
    InputMethodManager imm = (InputMethodManager) context.getSystemService(Activity.INPUT_METHOD_SERVICE);
    imm.hideSoftInputFromWindow(view.getWindowToken(), 0);
}

4. 使用Window的软输入模式

可以通过设置窗口的软输入模式来隐藏软键盘。

getWindow().setSoftInputMode(
    WindowManager.LayoutParams.SOFT_INPUT_STATE_ALWAYS_HIDDEN
);

5. 使用toggleSoftInput方法

通过toggleSoftInput方法来隐藏软键盘。

InputMethodManager imm = (InputMethodManager) getSystemService(Activity.INPUT_METHOD_SERVICE);
imm.toggleSoftInput(InputMethodManager.HIDE_IMPLICIT_ONLY, 0);

核心代码

Java代码示例

// 隐藏软键盘的工具类
public class KeyBoardUtils {

    public static void hideKeyboard(Activity activity) {
        InputMethodManager imm = (InputMethodManager) activity.getSystemService(Activity.INPUT_METHOD_SERVICE);
        View view = activity.getCurrentFocus();
        if (view == null) {
            view = new View(activity);
        }
        imm.hideSoftInputFromWindow(view.getWindowToken(), 0);
    }

    public static void hideKeyboardFrom(Context context, View view) {
        InputMethodManager imm = (InputMethodManager) context.getSystemService(Activity.INPUT_METHOD_SERVICE);
        imm.hideSoftInputFromWindow(view.getWindowToken(), 0);
    }
}

Kotlin代码示例

// 使用Kotlin扩展函数隐藏软键盘
import android.app.Activity
import android.view.View
import android.view.inputmethod.InputMethodManager
import androidx.fragment.app.Fragment

fun Activity.hideKeyboard(): Boolean {
    return (getSystemService(Activity.INPUT_METHOD_SERVICE) as InputMethodManager)
        .hideSoftInputFromWindow((currentFocus ?: View(this)).windowToken, 0)
}

fun Fragment.hideKeyboard(): Boolean {
    return (context?.getSystemService(Activity.INPUT_METHOD_SERVICE) as InputMethodManager)
        .hideSoftInputFromWindow((activity?.currentFocus ?: View(context)).windowToken, 0)
}

最佳实践

1. 确保上下文和视图的有效性

在调用隐藏软键盘的方法时，要确保传入的上下文和视图是有效的，避免出现空指针异常。

2. 处理不同场景

在不同的场景下，如Activity、Fragment、Dialog等，选择合适的方法来隐藏软键盘。

3. 考虑系统版本兼容性

不同的Android系统版本可能对软键盘的处理有所不同，要确保代码在不同版本上都能正常工作。

常见问题

1. 软键盘无法隐藏

• 原因：可能是视图的焦点问题，或者传入的窗口令牌无效。
• 解决方法：检查视图的焦点状态，确保获取到正确的窗口令牌。

2. 软键盘在特定场景下重新出现

• 原因：可能是系统的自动焦点机制导致软键盘重新出现。
• 解决方法：可以通过设置windowSoftInputMode属性来控制软键盘的显示和隐藏。

3. 代码在某些系统版本上不起作用

• 原因：不同的系统版本对InputMethodManager的实现可能有所不同。
• 解决方法：使用兼容性更好的方法，或者针对不同的系统版本进行特殊处理。