控制和动画化软件键盘

使用WindowInsetsCompat，您的应用可以查询和控制屏幕键盘（也称为IME），方式类似于它与系统栏交互的方式。您的应用还可以使用WindowInsetsAnimationCompat在打开或关闭软件键盘时创建无缝过渡。

图 1. 软件键盘打开-关闭过渡的两个示例。

先决条件

在设置软件键盘的控制和动画之前，请将您的应用配置为显示边缘到边缘。这允许它处理系统窗口内边距，例如系统栏和屏幕键盘。

检查键盘软件可见性

使用WindowInsets检查软件键盘可见性。

Kotlin

val insets = ViewCompat.getRootWindowInsets(view) ?: return
val imeVisible = insets.isVisible(WindowInsetsCompat.Type.ime())
val imeHeight = insets.getInsets(WindowInsetsCompat.Type.ime()).bottom

Java

WindowInsetsCompat insets = ViewCompat.getRootWindowInsets(view);
boolean imeVisible = insets.isVisible(WindowInsetsCompat.Type.ime());
int imeHeight = insets.getInsets(WindowInsetsCompat.Type.ime()).bottom;

或者，您可以使用ViewCompat.setOnApplyWindowInsetsListener来观察软件键盘可见性的变化。

Kotlin

ViewCompat.setOnApplyWindowInsetsListener(view) { _, insets ->
  val imeVisible = insets.isVisible(WindowInsetsCompat.Type.ime())
  val imeHeight = insets.getInsets(WindowInsetsCompat.Type.ime()).bottom
  insets
}

Java

ViewCompat.setOnApplyWindowInsetsListener(view, (v, insets) -> {
  boolean imeVisible = insets.isVisible(WindowInsetsCompat.Type.ime());
  int imeHeight = insets.getInsets(WindowInsetsCompat.Type.ime()).bottom;
  return insets;
});

将动画与软件键盘同步

用户点击文本输入字段会导致键盘从屏幕底部滑入到位，如下例所示

图 2. 同步键盘动画。

图 2 中标记为“不同步”的示例显示了 Android 10（API 级别 29）中的默认行为，其中应用的文本字段和内容会卡入到位，而不是与键盘动画同步——这种行为在视觉上可能会令人反感。
在 Android 11（API 级别 30）及更高版本中，您可以使用WindowInsetsAnimationCompat将应用的过渡与键盘从屏幕底部向上和向下滑动同步。这看起来更流畅，如图 2 中标记为“同步”的示例所示。

使用要与键盘动画同步的视图配置WindowInsetsAnimationCompat.Callback。

Kotlin

ViewCompat.setWindowInsetsAnimationCallback(
  view,
  object : WindowInsetsAnimationCompat.Callback(DISPATCH_MODE_STOP) {
    // Override methods.
  }
)

Java

ViewCompat.setWindowInsetsAnimationCallback(
    view,
    new WindowInsetsAnimationCompat.Callback(
        WindowInsetsAnimationCompat.Callback.DISPATCH_MODE_STOP
    ) {
      // Override methods.
    });

在WindowInsetsAnimationCompat.Callback中有一些方法可以重写，即onPrepare()、onStart()、onProgress()和onEnd()。在任何布局更改之前，首先调用onPrepare()。

onPrepare在内边距动画开始并且由于动画而重新布局视图之前被调用。您可以使用它来保存起始状态，在本例中是视图的底部坐标。

An image showing the start state bottom coordinate of the root view. — **图 3.** 使用`onPrepare()`记录起始状态。

以下代码片段显示了对onPrepare的示例调用

Kotlin

var startBottom = 0f

override fun onPrepare(
  animation: WindowInsetsAnimationCompat
) {
  startBottom = view.bottom.toFloat()
}

Java

float startBottom;

@Override
public void onPrepare(
    @NonNull WindowInsetsAnimationCompat animation
) {
  startBottom = view.getBottom();
}

onStart在内边距动画开始时被调用。您可以使用它将所有视图属性设置为布局更改的结束状态。如果您已将OnApplyWindowInsetsListener回调设置为任何视图，则此时已调用它。这是保存视图属性结束状态的好时机。

An image showing the end state bottom coordinate of the view — **图 4.** 使用`onStart()`记录结束状态。

以下代码片段显示了对onStart的示例调用

Kotlin

var endBottom = 0f

override fun onStart(
  animation: WindowInsetsAnimationCompat,
  bounds: WindowInsetsAnimationCompat.BoundsCompat
): WindowInsetsAnimationCompat.BoundsCompat {
  // Record the position of the view after the IME transition.
  endBottom = view.bottom.toFloat()

  return bounds
}

Java

float endBottom;

@NonNull
@Override
public WindowInsetsAnimationCompat.BoundsCompat onStart(
    @NonNull WindowInsetsAnimationCompat animation,
    @NonNull WindowInsetsAnimationCompat.BoundsCompat bounds
) {
  endBottom = view.getBottom();
  return bounds;
}

onProgress在内边距作为运行动画的一部分发生更改时被调用，因此您可以重写它并在键盘动画期间的每一帧上收到通知。更新视图属性，以便视图与键盘同步动画。

此时所有布局更改都已完成。例如，如果您使用View.translationY来移动视图，则此方法的每次调用都会使该值逐渐减小，最终达到0 到原始布局位置。

图 5. 使用onProgress()同步动画。

以下代码片段显示了对onProgress的示例调用

Kotlin

override fun onProgress(
  insets: WindowInsetsCompat,
  runningAnimations: MutableList<WindowInsetsAnimationCompat>
): WindowInsetsCompat {
  // Find an IME animation.
  val imeAnimation = runningAnimations.find {
    it.typeMask and WindowInsetsCompat.Type.ime() != 0
  } ?: return insets

  // Offset the view based on the interpolated fraction of the IME animation.
  view.translationY =
    (startBottom - endBottom) * (1 - imeAnimation.interpolatedFraction)

  return insets
}

Java

@NonNull
@Override
public WindowInsetsCompat onProgress(
    @NonNull WindowInsetsCompat insets,
    @NonNull List<WindowInsetsAnimationCompat> runningAnimations
) {
  // Find an IME animation.
  WindowInsetsAnimationCompat imeAnimation = null;
  for (WindowInsetsAnimationCompat animation : runningAnimations) {
    if ((animation.getTypeMask() & WindowInsetsCompat.Type.ime()) != 0) {
      imeAnimation = animation;
      break;
    }
  }
  if (imeAnimation != null) {
    // Offset the view based on the interpolated fraction of the IME animation.
    view.setTranslationY((startBottom - endBottom)

        *   (1 - imeAnimation.getInterpolatedFraction()));
  }
  return insets;
}

您可以选择重写onEnd。此方法在动画结束后被调用。这是清理任何临时更改的好时机。

其他资源

GitHub 上的 WindowInsetsAnimation。