Android软键盘挡住输入框的终极解决方案

概述前言开发做得久了，总免不了会遇到各种坑。而在Android开发的路上，『软键盘挡住了输入框』这个坑，可谓是一个旷日持久的巨坑――来来来，我们慢慢看。

前言

开发做得久了，总免不了会遇到各种坑。

而在AndroID开发的路上，『软键盘挡住了输入框』这个坑，可谓是一个旷日持久的巨坑――来来来，我们慢慢看。

入门篇

最基本的情况，如图所示：在页面底部有一个EditText，如果不做任何处理，那么在软键盘d出的时候，就有可能会挡住EditText。

对于这种情况的处理其实很简单，只需要在AndroIDManifest文件中对activity设置：androID:windowsoftinputMode的值adjustPan或者adjustResize即可，像这样：

<activityandroID:name=".MainActivity"androID:windowsoftinputMode="adjustPan" >...</activity>

一般来说，他们都可以解决问题，当然，adjustPan跟adjustResize的效果略有区别。

adjustPan是把整个界面向上平移，使输入框露出，不会改变界面的布局；

adjustResize则是重新计算d出软键盘之后的界面大小，相当于是用更少的界面区域去显示内容，输入框一般自然也就在内了。

↑↑↑ OK，这只是入门，基本上地球上所有的AndroID工程师都能搞定。

别急，看下面~

加上WebVIEw试试看？坑来了……

上面的入门篇中，软键盘是由原生的EditText触发d出的。而在H5、HybrID几乎已经成为App标配的时候，我们经常还会碰到的情况是：软键盘是由WebVIEw中的网页元素所触发d出的。

情况描述

这时候，情况就会变得复杂了:

首先，页面是非全屏模式的情况下，给activity设置adjustPan会失效。

其次，页面是全屏模式的情况，adjustPan跟adjustResize都会失效。

――解释一下，这里的全屏模式即是页面是全屏的，包括Application或activity使用了Fullscreen主题、使用了『状态色着色』、『沉浸式状态栏』、『Immersive Mode』等等――总之，基本上只要是App自己接管了状态栏的控制，就会产生这种问题。

下面这个表格可以简单列举了具体的情况。

为什么说它是个坑？”issue 5497”

上面表格的这种情况并非是Google所期望的，理想的情况当然是它们都能正常生效才对――所以这其实是AndroID系统本身的一个BUG。

为什么文章开头说这是个坑呢？

――因为这个BUG从AndroID1.x时代（2009年）就被报告了，而一直到了如今的Android7.0（2016年）还是没有修复……/(ㄒoㄒ)/
可以说这不仅是个坑，而且还是个官方挖的坑~

“issue 5497”，详情传送门 ☞ Issue 5497 - androID -WebVIEw adjustResize windowsoftinputMode breaks when activity is fullscreen - AndroID Open Source Project - Issue Tracker - Google Project Hosting

当然了，不管坑是谁挖的，最终还是要开发者来解决。

遇到坑之后，有两种方法可以过去：躲，或者填。

躲坑姿势

如前文所示，出现坑的条件是：带有WebVIEw的activity使用了全屏模式或者adjustPan模式。

那么躲坑的姿势就很简单了――

如果activity中有WebVIEw，就不要使用全屏模式，并且把它的windowsoftinputMode值设为adjustResize就好了嘛

怎么样，是不是很简单？

但总有些时候，是需要全屏模式跟WebVIEw兼得的，这时候，躲坑就不行了，我们需要一个新的填坑的姿势。幸好，开发者的智慧是无穷的，这个坑出现了这么多年，还是有人找到了一些解决方案的。

AndroIDBUG5497Workaround

我个人认为最好的解决方案是这个：AndroidBug5497Workaround，只需要一个神奇的AndroIDBUG5497Workaround类。

看名字就知道，它是专门用来对付”5497”问题的，使用步骤也是超级简单：

把AndroIDBUG5497Workaround类复制到项目中

在需要填坑的activity的onCreate方法中添加一句AndroIDBUG5497Workaround.assistActivity(this)即可。

经过测试，基本在各个AndroID版本上都可用，效果基本与设置了adjustResize相当。

看一个对比图：

来自我厂App的某个使用WebVIEw的全屏模式Activity页面，从左到右分别是：没有软键盘的样式、软键盘挡住输入框的效果、以及使用AndroIDBUG5497Workaround之后的最终效果。

它的原理是什么？

这个炫酷AndroIDBUG5497Workaround类，其实并不是很复杂，只有几十行代码，先贴在这里：

public class AndroIDBUG5497Workaround {// For more information,see https://code.Google.com/p/androID/issues/detail?ID=5497// To use this class,simply invoke assistActivity() on an Activity that already has its content vIEw set.public static voID assistActivity (Activity activity) {new AndroIDBUG5497Workaround(activity);}private VIEw mChildOfContent;private int usableHeightPrevIoUs;private FrameLayout.LayoutParams frameLayoutParams;private AndroIDBUG5497Workaround(Activity activity) {FrameLayout content = (FrameLayout) activity.findVIEwByID(androID.R.ID.content);mChildOfContent = content.getChildAt(0);mChildOfContent.getVIEwTreeObserver().addOnGlobalLayoutListener(new VIEwTreeObserver.OnGlobalLayoutListener() {public voID onGlobalLayout() {possiblyResizeChildOfContent();}});frameLayoutParams = (FrameLayout.LayoutParams) mChildOfContent.getLayoutParams();}private voID possiblyResizeChildOfContent() {int usableHeightNow = computeUsableHeight();if (usableHeightNow != usableHeightPrevIoUs) {int usableHeightSansKeyboard = mChildOfContent.getRootVIEw().getHeight();int heightDifference = usableHeightSansKeyboard - usableHeightNow;if (heightDifference > (usableHeightSansKeyboard/4)) {// keyboard probably just became visibleframeLayoutParams.height = usableHeightSansKeyboard - heightDifference;} else {// keyboard probably just became hIDdenframeLayoutParams.height = usableHeightSansKeyboard;}mChildOfContent.requestLayout();usableHeightPrevIoUs = usableHeightNow;}}private int computeUsableHeight() {Rect r = new Rect();mChildOfContent.getwindowVisibledisplayFrame(r);return (r.bottom - r.top);// 全屏模式下： return r.bottom}}

代码大致是做了这么几件事：

1.找到activity的根VIEw

看一下入口的代码：

FrameLayout content = (FrameLayout) activity.findVIEwByID(androID.R.ID.content);mChildOfContent = content.getChildAt(0);

其中，第一行中的androID.R.ID.content所指的VIEw，是AndroID所有Activity界面上开发者所能控制的区域的根VIEw。

如果Activity是全屏模式，那么androID.R.ID.content就是占满全部屏幕区域的。

如果Activity是普通的非全屏模式，那么androID.R.ID.content就是占满除状态栏之外的所有区域。

其他情况，如Activity是d窗、或者7.0以后的分屏样式等，androID.R.ID.content也是d窗的范围或者分屏所在的半个屏幕――这些情况较少，就暂且不考虑了。

我们经常用的setContentVIEw(VIEw vIEw)/setContent(int layRes)其实就是把我们指定的VIEw或者layRes放到androID.R.ID.content里面，成为它的子VIEw。

所以，然后，第二行content.getChildAt(0)获取到的mChildOfContent，其实也就是用以获取到我们用setContentVIEw放进去的VIEw。

2.设置一个Listener监听VIEw树变化

mChildOfContent.getVIEwTreeObserver().addOnGlobalLayoutListener({ //简化了写法possiblyResizeChildOfContent();});

VIEw.getVIEwTreeObserver()可以获取一个VIEwTreeObserver对象――这个对象是一个观察者，专门用以监听当前VIEw树所发生的一些变化。这里所注册的addOnGlobalLayoutListener，就是会在当前的VIEw树的全局布局（GlobalLayout）发生变化、或者其中的VIEw可视状态有变化时，进行通知回调。

――『软键盘d出』，则是会触发这个事件的一个源。 (软键盘d出会使GlobalLayout发生变化)

也就是说，现在能监听到『软键盘d出』的事件了。

3.界面变化之后，获取”可用高度”

当软键盘d出了之后，接下来的事情是获取改变之后的界面的可用高度（可以被开发者用以显示内容的高度）。

直接看代码：

private int computeUsableHeight() {Rect rect = new Rect();mChildOfContent.getwindowVisibledisplayFrame(rect);// rect.top其实是状态栏的高度，如果是全屏主题，直接 return rect.bottom就可以了return (rect.bottom - rect.top);}

VIEw.getwindowVisibledisplayFrame(Rect rect)，这行代码能够获取到的Rect――就是界面除去了标题栏、除去了被软键盘挡住的部分，所剩下的矩形区域――如图所示，红框中的区域。

Rect区域示意图

也可以看出：

rect.top值，其实就是标题栏的高度。（实际上，这也常常被用作为获取标题栏高度的方法）

屏幕高度-rect.bottom，是软键盘的高度。（获取软键盘高度的方法也出现了）
这时，就有：

全屏模式下，可用高度 = rect.bottom

非全屏模式，可用高度 = rect.bottom - rect.top

4.最后一步，重设高度

我们计算出的可用高度，是目前在视觉效果上能看到的界面高度。但当前界面的实际高度是比可用高度要多出一个软键盘的距离的。

所以，最后一步，就是把界面高度置为可用高度――大功告成。

private voID possiblyResizeChildOfContent() {int usableHeightNow = computeUsableHeight();if (usableHeightNow != usableHeightPrevIoUs) {int usableHeightSansKeyboard = mChildOfContent.getRootVIEw().getHeight();int heightDifference = usableHeightSansKeyboard - usableHeightNow;if (heightDifference > (usableHeightSansKeyboard/4)) {// keyboard probably just became visibleframeLayoutParams.height = usableHeightSansKeyboard - heightDifference;} else {// keyboard probably just became hIDdenframeLayoutParams.height = usableHeightSansKeyboard;}mChildOfContent.requestLayout();usableHeightPrevIoUs = usableHeightNow;}}

上面的代码里添加了一个”heightDifference > (usableHeightSansKeyboard/4)”的判断，这是为了去除无谓的干扰。因为能触发OnGlobalLayout事件的原因有很多，不止是软键盘的d出变化，还包括各种子VIEw的隐藏显示变化等，它们对界面高度的影响有限。加上了这个判断之后，只有界面的高度变化超过1/4的屏幕高度，才会进行重新设置高度，基本能保证代码只响应软键盘的d出。

总结

总结起来，就是这样：

普通Activity（不带WebVIEw），直接使用adjustpan或者adjustResize

如果带WebVIEw：

a) 如果非全屏模式，可以使用adjustResize

b) 如果是全屏模式，则使用AndroIDBUG5497Workaround进行处理。

以上所述是小编给大家介绍的AndroID软键盘挡住输入框的终极解决方案，希望对大家有所帮助，如果大家有任何疑问请给我留言，小编会及时回复大家的。在此也非常感谢大家对编程小技巧网站的支持！

总结

以上是内存溢出为你收集整理的Android软键盘挡住输入框的终极解决方案全部内容，希望文章能够帮你解决Android软键盘挡住输入框的终极解决方案所遇到的程序开发问题。

如果觉得内存溢出网站内容还不错，欢迎将内存溢出网站推荐给程序员好友。