处理输入法可见性

编写:zhaochunqi - 原文:http://developer.android.com/training/keyboard-input/visibility.html

当输入焦点移入或移出可编辑的文本框时,Android会相应的显示或隐藏输入法(如虚拟键盘)。系统也会决定输入法上方的 UI 和文本框的显示方式。举例来说,当屏幕上垂直空间被压缩时,文本框可能填充输入法上方所有的空间。对于多数的应用来说,这些默认的行为基本就足够了。

然而,在一些事例中,我们可能会想要更加直接地控制输入法的显示,指定在输入法显示的时候,如何显示我们的布局。这节课会解释如何控制和响应输入法的可见性。

在Activity启动时显示输入法

尽管Android会在Activity启动时将焦点放在布局中的第一个文本框,但是并不会显示输入法。因为输入文本可能并不是activity中的首要任务,所以不显示输入法是很合理的。可是,如果输入文本确实是首要的任务(如在登录界面中),那么可能需要默认显示输入法。

为了在activity启动时显示输入法,添加 android:windowSoftInputMode 属性到 <activity> 节点中,并将该属性的值设为 "stateVisible"。如下:

<application ... >
    <activity
        android:windowSoftInputMode="stateVisible" ... >
        ...
    </activity>
    ...
</application>

Note: 如果用户的设备有一个实体键盘,那么不会显示软输入法。

根据需要显示输入法

如果我们想要确保输入法在activity生命周期的某个方法中是可见的,那么可以使用 InputMethodManager 来实现。

举例来说,下面的方法调用了一个需要用户填写文本的View,调用了 requestFocus() 来获取焦点,然后调用 showSoftInput() 来打开输入法。

public void showSoftKeyboard(View view) {
    if (view.requestFocus()) {
        InputMethodManager imm = (InputMethodManager)
                getSystemService(Context.INPUT_METHOD_SERVICE);
        imm.showSoftInput(view, InputMethodManager.SHOW_IMPLICIT);
    }
}

Note: 一旦输入法可见,我们不应该以编程的方式来隐藏它。系统会在用户结束文本框的任务时隐藏输入法,或者可以使用系统控制(如返回键)来隐藏。

指定 UI 的响应方式

当输入法显示在屏幕上时,会减少 app UI 中的可用空间。系统会决定如何调整 UI 可见的部分,但是这样做不一定正确。为了确保应用的最佳表现,我们应该在 UI 的剩余空间中展示我们想要展示的系统界面。

为了在activity中声明合适的处理方法,可以在 manifest 文件的 <activity> 节点中使用 android:windowSoftInputMode 属性,并将该属性的值设为"adjust"。

举例来说,为了确保系统会在可用空间中重新调整布局的大小——确保所有的布局内容都可以被使用(尽管可能需要滑动)——使用 "adjustResize":

<application ... >
    <activity
        android:windowSoftInputMode="adjustResize" ... >
        ...
    </activity>
    ...
</application>

我们可以结合上述调整说明和初始化输入法可见性说明:

    <activity
        android:windowSoftInputMode="stateVisible|adjustResize" ... >
        ...
    </activity>

如果 UI 中包含用户可能需要在文本输入时立即执行的事情,那么使用 "adjustResize" 是很重要的。例如,如果我们使用相对布局(relative layout)在屏幕底部放置一个按钮,用 "adjustResize" 来重新调整大小,使得按钮栏出现在输入法上方。