处理输入法可见性

当输入焦点移入或移出可编辑文本字段时，Android 会显示或 隐藏输入（例如屏幕键盘）， 适当的选择。系统还会决定您的界面和文本字段在上方的显示方式 输入方法例如，当屏幕上的垂直空间为 那么文本字段可能会填满输入法上方的所有空间。

对于大多数应用来说，这些默认行为就足够了。在某些情况下 但您可能希望更好地控制输入法的可见性 对布局的影响本课将介绍如何控制和响应 输入法可见性。

注意： 本页通篇提到短语“软键盘”， 代表屏幕键盘，是最常见的软输入类型 方法。Android 支持其他类型的软键盘输入法，包括图片 输入和手写绘图。

在 activity 启动时显示软键盘

尽管在 则不会显示软键盘。这种行为是适当的 因为输入文本可能不是 activity 中的主要任务。但是，如果 比如在登录屏幕中，输入文本是主要任务， 可能希望默认显示软键盘。

如需在 Activity 启动时显示输入法，请将 android:windowSoftInputMode 属性 值为 "stateVisible" 的 <activity> 元素。例如：

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

注意 ：如果用户的设备连接了硬件键盘，则软键盘 不会出现。

指定界面的响应方式

当屏幕上显示软键盘时，这会减少空间 自定义属性由系统决定如何调整 部分，但可能不会做得很好。为了确保最佳行为 指定您希望系统如何在 剩余空间

如需在 activity 中声明您的首选处理方式，请使用 清单的 <activity> 元素中的 android:windowSoftInputMode 属性 其中设置了一个“调整”值。

例如，要确保系统将布局大小调整为 这样就能确保布局内容可供访问 需要滚动 - 使用 "adjustResize"：

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

您可以将调整规范与初始软键盘结合使用 可见性规范：

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

如果界面包含"adjustResize" 用户可能需要在输入文本之后或过程中立即访问。对于 例如，如果您使用相对布局将按钮栏放置在 屏幕，使用 "adjustResize" 可调整布局大小，以显示按钮栏 。

按需显示软键盘

如果您想在 activity 的生命周期中通过某个方法确保 输入法是否可见，则可以使用 InputMethodManager 进行显示。

例如，以下方法接受一个 View，用户应在其中 打字、打电话 requestFocus()： 然后调用 showSoftInput() 以打开输入法：

Kotlin

fun showSoftKeyboard(view: View) {
   if (view.requestFocus()) {
       val imm = getSystemService(InputMethodManager::class.java)
       imm.showSoftInput(view, InputMethodManager.SHOW_IMPLICIT)
   }
}

Java

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

注意 ：显示软键盘后，请不要以编程方式将其隐藏。通过 当用户在文本字段中完成任务时，系统会隐藏输入法。 或者，用户也可以使用系统控件（例如使用“Back”按钮）将其隐藏 按钮。

注意 ：请勿在SHOW_FORCED showSoftInput() 来请求软键盘。否则， 即使应用已关闭，键盘仍可保持打开状态。

可靠地显示软键盘

有些情况下（例如当 activity 启动时）， 使用 InputMethodManager.showSoftInput() 显示软键盘 可能导致用户无法看到软件键盘。

使用 showSoftInput() 时，软键盘的可见性取决于 用于以下条件：

• 视图必须已连接到软件键盘。（反过来， 需要窗口聚焦和编辑器 来请求视图焦点 View.requestFocus()）。

• 可见性还会受到 android:windowSoftInputMode 的影响 showSoftInput() 使用的属性和标记。

在某些用例中，例如当 activity 启动时，部分用例 不符合必需的条件。系统不会将该视图视为 连接到软件键盘时，会忽略 showSoftInput() 调用， 并且对用户不可见。

为确保软件键盘可靠地显示，您可以使用以下代码 替代方案：

• （推荐）使用 WindowInsetsControllerCompat。此对象 在 Activity.onCreate() 期间显示软键盘，如 以下代码段中。系统会保证将此通话安排在相应时段 目标。

Kotlin

editText.requestFocus()
WindowCompat.getInsetsController(window, editText)!!.show(WindowInsetsCompat.Type.ime())

Java

editText.requestFocus();
WindowCompat.getInsetsController(getWindow(), editText).show(WindowInsetsCompat.Type.ime());

• 发布一个可运行对象。这可确保您的应用等到收到 在调用之前来自 View.onWindowFocusChanged() 的窗口焦点事件 showSoftInput()。

Kotlin

class MyEditText : EditText() {
  ...
  override fun onWindowFocusChanged(hasWindowFocus: Boolean) {
    if (hasWindowFocus) {
      requestFocus()
      post {
        val imm: InputMethodManager = getSystemService(InputMethodManager::class.java)
        imm.showSoftInput(this, 0)
      }
    }
  }
}

Java

public class MyEditText extends EditText {
  ...
  @Override
  public void onWindowFocusChanged(boolean hasWindowFocus) {
    if (hasWindowFocus) {
      requestFocus();
      post(() -> {
        InputMethodManager imm = getSystemService(InputMethodManager.class);
        imm.showSoftInput(this, 0);
      });
    }
  }
}

谨慎处理运行时可见性标志

在运行时切换软键盘可见性时，请注意不要将某些 标志值传递到这些方法中。例如，如果应用需要 通话时显示软键盘 Activity.onCreate()期间：View.getWindowInsetsController().show(ime()) activity 启动时，应用开发者应小心谨慎，切勿将 SOFT_INPUT_STATE_HIDDEN 或 SOFT_INPUT_STATE_ALWAYS_HIDDEN 标志 以防软键盘意外隐藏。

系统通常会自动隐藏软键盘

在大多数情况下，系统会处理隐藏软键盘的操作。这个 可以是以下任意一种：

• 用户在文本字段中完成任务。
• 用户按下返回键或使用返回导航滑动手势。
• 用户导航到另一个应用，并且该应用已设置 SOFT_INPUT_STATE_HIDDEN 或 SOFT_INPUT_STATE_ALWAYS_HIDDEN 标志 在视图获得焦点时触发。

。

注意： 聚焦于文本字段以外的视图不会关闭软键盘

根据以前的系统行为手动隐藏软键盘

在某些情况下，您的应用必须手动隐藏软键盘，例如 例如，在 View.OnFocusChangeListener.onFocusChange。谨慎使用这一技巧 ；关闭软键盘意外影响用户体验。

如果您的应用手动隐藏软键盘，您需要知道 以显式方式或隐式方式显示软键盘：

• 之后被视为明确显示软键盘。 对 showSoftInput() 的调用。

• 反之，则认为软键盘已隐式显示在 以下任一情况：

  • 在应用 android:windowSoftInputMode。
  • 您的应用将 SHOW_IMPLICIT 传递给 showSoftInput()。

通常，无论如何选择 hideSoftInputFromWindow() 都会隐藏软键盘 请求中包含 HIDE_IMPLICIT_ONLY 可以限定为仅关闭隐式请求的软键盘。

在软键盘顶部显示对话框或叠加视图

在某些情况下，编辑器 activity 可能需要创建一个不可修改的 对话框或叠加窗口。

您的应用具有几个选项，具体如以下部分所述。

总之，请确保正确处理软键盘的窗口标记 定位时间范围，使其满足以下预期 关于垂直（z 层）排序：

• 无标志（正常情况）：位于软键盘层之后，可以接收文本。
• FLAG_NOT_FOCUSABLE ：位于软键盘层之上，但无法接收文本。
• FLAG_ALT_FOCUSABLE_IM ：在软键盘层之上，可以聚焦，但不连接到 软键盘。还会阻止其下的所有视图连接到 软键盘。这对于显示不使用文本的应用对话框非常有用 输入层。
• FLAG_NOT_FOCUSABLE 和FLAG_ALT_FOCUSABLE_IM ：位于软键盘层之后，但无法接收文本。
• FLAG_NOT_FOCUSABLE 和FLAG_NOT_TOUCH_MODAL ：位于软键盘顶部，允许触摸事件“穿过” 切换到软键盘上。

创建对话框

使用 FLAG_ALT_FOCUSABLE_IM dialog 窗口标志，用于将对话框置于软键盘之上；以及用于 阻止软键盘获得焦点：

Kotlin

val content = TextView(this)
content.text = "Non-editable dialog on top of soft keyboard"
content.gravity = Gravity.CENTER
val builder = AlertDialog.Builder(this)
  .setTitle("Soft keyboard layering demo")
  .setView(content)
mDialog = builder.create()
mDialog!!.window!!
  .addFlags(WindowManager.LayoutParams.FLAG_ALT_FOCUSABLE_IM)
mDialog!!.show()

Java

TextView content = new TextView(this);
content.setText("Non-editable dialog on top of soft keyboard");
content.setGravity(Gravity.CENTER);
final AlertDialog.Builder builder = new AlertDialog.Builder(this)
    .setTitle("Soft keyboard layering demo")
    .setView(content);
mDialog = builder.create();
mDialog.getWindow().addFlags(FLAG_ALT_FOCUSABLE_IM);
mDialog.show();

创建叠加层视图

创建指定 TYPE_APPLICATION_OVERLAY 的叠加层视图 窗口类型和 FLAG_ALT_FOCUSABLE_IM 针对软键盘的 Activity 设置的窗口标志。

注意 ：这需要用户授予 SYSTEM_ALERT_WINDOW 特殊 权限。

Kotlin

val params = WindowManager.LayoutParams(
  width,  /* Overlay window width */
  height,  /* Overlay window height */
  WindowManager.LayoutParams.TYPE_APPLICATION, /* Overlay window type */
  WindowManager.LayoutParams.FLAG_ALT_FOCUSABLE_IM /* No need to allow for text input on top of the soft keyboard */
    or WindowManager.LayoutParams.FLAG_NOT_TOUCH_MODAL,  /* Allow touch event send to soft keyboard behind the overlay */
  PixelFormat.TRANSLUCENT
)
params.title = "Overlay window"
mOverlayView!!.layoutParams = params
windowManager.addView(mOverlayView, params)

Java

WindowManager.LayoutParams params = new WindowManager.LayoutParams(
    width, /* Overlay window width */
    height, /* Overlay window height */
    TYPE_APPLICATION, /* Overlay window type */
    FLAG_ALT_FOCUSABLE_IM /* No need to allow for text input on top of the soft keyboard */
        | FLAG_NOT_TOUCH_MODAL, /* Allow touch event send to soft keyboard behind the overlay */
    PixelFormat.TRANSLUCENT);
params.setTitle("Overlay window");
mOverlayView.setLayoutParams(params);
getWindowManager().addView(mOverlayView, params);

在软键盘下方显示对话框或视图

您的应用可能需要创建一个对话框或窗口，其中包含 以下属性：

• 显示在编辑器 activity 请求的软键盘下方 使其不受文本输入的影响。
• 始终知晓软键盘边衬区大小的变化 调整对话框或窗口的布局。

在这种情况下，您的应用会提供多种选项。以下部分 介绍这些选项

创建对话框

通过同时设置 FLAG_NOT_FOCUSABLE 来创建对话框 窗口标志和 FLAG_ALT_FOCUSABLE_IM 窗口标志：

Kotlin

val content = TextView(this)
content.text = "Non-editable dialog behind soft keyboard"
content.gravity = Gravity.CENTER
val builder = AlertDialog.Builder(this)
  .setTitle("Soft keyboard layering demo")
  .setView(content)
mDialog = builder.create()
mDialog!!.window!!
  .addFlags(FLAG_NOT_FOCUSABLE or FLAG_ALT_FOCUSABLE_IM)
mDialog!!.show()

Java

TextView content = new TextView(this);
content.setText("Non-editable dialog behind soft keyboard");
content.setGravity(Gravity.CENTER);
final AlertDialog.Builder builder = new AlertDialog.Builder(this)
    .setTitle("Soft keyboard layering demo")
    .setView(content);

mDialog = builder.create();
mDialog.getWindow()
    .addFlags(FLAG_NOT_FOCUSABLE | FLAG_ALT_FOCUSABLE_IM);
mDialog.show();

创建叠加层视图

通过同时设置 FLAG_NOT_FOCUSABLE 来创建叠加层视图 窗口标志和 FLAG_ALT_FOCUSABLE_IM 窗口标志：

Kotlin

val params = WindowManager.LayoutParams(
  width,  /* Overlay window width */
  height,  /* Overlay window height */
  WindowManager.LayoutParams.TYPE_APPLICATION,  /* Overlay window type */
  WindowManager.LayoutParams.FLAG_NOT_FOCUSABLE
      or WindowManager.LayoutParams.FLAG_ALT_FOCUSABLE_IM,
  PixelFormat.TRANSLUCENT
)
params.title = "Overlay window"
mOverlayView!!.layoutParams = params
windowManager.addView(mOverlayView, params)

Java

WindowManager.LayoutParams params = new WindowManager.LayoutParams(
    width, /* Overlay window width */
    height, /* Overlay window height */
    TYPE_APPLICATION, /* Overlay window type */
    FLAG_NOT_FOCUSABLE | FLAG_ALT_FOCUSABLE_IM,
    PixelFormat.TRANSLUCENT);
params.setTitle("Overlay window");
mOverlayView.setLayoutParams(params);
getWindowManager().addView(mOverlayView, params);