如何阻止 Android 活动启动时 EditText 获得焦点

技术背景

在 Android 开发中，当活动启动时，EditText 有时会自动获得焦点并弹出虚拟键盘，这可能不是用户期望的行为。为了提升用户体验，我们需要阻止 EditText 在活动启动时获得焦点。

实现步骤

方法一：在父布局添加属性

在父布局（如 LinearLayout 或 ConstraintLayout）中添加 android:focusable="true" 和 android:focusableInTouchMode="true" 属性，示例代码如下：

<!-- Dummy item to prevent AutoCompleteTextView from receiving focus -->
<LinearLayout
    android:focusable="true" 
    android:focusableInTouchMode="true"
    android:layout_width="0px" 
    android:layout_height="0px"/>

<!-- :nextFocusUp and :nextFocusLeft have been set to the id of this component
to prevent the dummy from receiving focus again -->
<AutoCompleteTextView android:id="@+id/autotext"
    android:layout_width="fill_parent" 
    android:layout_height="wrap_content"
    android:nextFocusUp="@id/autotext" 
    android:nextFocusLeft="@id/autotext"/>

方法二：设置窗口软输入模式

在 AndroidManifest.xml 的 <activity> 标签中设置 android:windowSoftInputMode 属性，示例代码如下：

<activity
    android:name=".MyActivity"
    android:windowSoftInputMode="stateAlwaysHidden"/>

• android:windowSoftInputMode="stateHidden"：进入活动时始终隐藏软键盘。
• android:windowSoftInputMode="stateUnchanged"：不改变软键盘状态。
• android:windowSoftInputMode="stateAlwaysHidden"：始终隐藏软键盘。

方法三：移除 EditText 中的 <requestFocus />

确保在 EditText 的 XML 标签声明末尾移除 <requestFocus /> 这一行，示例代码如下：

<EditText
    android:id="@+id/emailField"
    android:layout_width="fill_parent"
    android:layout_height="wrap_content"
    android:inputType="textEmailAddress">
    <!-- <requestFocus /> /* <-- without this line */ -->
</EditText>

方法四：使用代码控制焦点

在 onResume() 方法中使用 clearFocus() 和 requestFocus() 方法控制焦点，示例代码如下：

@Override
protected void onResume() {
    super.onResume();
    //do not give the editbox focus automatically when activity starts
    mAutoCompleteTextView.clearFocus();
    mLinearLayout.requestFocus();
}

方法五：设置 EditText 的 focusable 属性

在 XML 中设置 EditText 的 focusable 属性为 false，并在 Java 代码中添加触摸监听器，示例代码如下：

<EditText
    android:id="@+id/et_bonus_custom"
    android:focusable="false" />

etBonus.setOnTouchListener(new View.OnTouchListener() {
    @Override
    public boolean onTouch(View v, MotionEvent event) {
        v.setFocusable(true);
        v.setFocusableInTouchMode(true);
        return false;
    }
});

核心代码

父布局属性设置

<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:id="@+id/mainLayout"
    android:descendantFocusability="beforeDescendants"
    android:focusableInTouchMode="true" >

窗口软输入模式设置

<activity
    android:name=".MyActivity"
    android:windowSoftInputMode="stateAlwaysHidden"/>

代码控制焦点

@Override
protected void onResume() {
    super.onResume();
    mAutoCompleteTextView.clearFocus();
    mLinearLayout.requestFocus();
}

最佳实践

• 结合多种方法使用，如同时在父布局添加属性和设置窗口软输入模式。
• 根据具体需求选择合适的方法，例如如果只需要隐藏软键盘，可以使用 android:windowSoftInputMode 属性。

常见问题

方法无效

如果某些方法无效，可以尝试结合多种方法一起使用，或者检查代码是否存在其他影响焦点的因素。

软键盘仍然弹出

确保在 AndroidManifest.xml 中正确设置了 android:windowSoftInputMode 属性，并且移除了 EditText 中的 <requestFocus /> 标签。