本文由BarryZhang原创,同一时候首发于diycode.cc、barryzhang.com 、github.com/barryhappy。非商业转载请注明作者和原文链接。
前言
开发做得久了。总免不了会遇到各种坑。
而在Android开发的路上,『软键盘挡住了输入框』这个坑。可谓是一个旷日持久的巨坑——来来来。我们慢慢看。
入门篇
最主要的情况,如图所看到的:在页面底部有一个EditText。假设不做不论什么处理,那么在软键盘弹出的时候,就有可能会挡住EditText。
对于这样的情况的处理事实上非常easy。仅仅须要在AndroidManifest文件里对activity设置:android:windowSoftInputMode
的值adjustPan
或者adjustResize
就可以。像这样:
<activity
android:name=".MainActivity"
android:windowSoftInputMode="adjustPan" >
...
</activity>
一般来说,他们都能够解决这个问题。当然。adjustPan
跟adjustResize
的效果略有差别。
-
adjustPan
是把整个界面向上平移。使输入框露出。不会改变界面的布局; -
adjustResize
则是又一次计算弹出软键盘之后的界面大小,相当于是用更少的界面区域去显示内容。输入框一般自然也就在内了。
↑↑↑ OK,这仅仅是入门,基本上地球上全部的Androidproject师都能搞定。
别急,看以下~
加上WebView试试看?坑来了……
上面的入门篇中,软键盘是由原生的EditText触发弹出的。
而在H5、Hybrid差点儿已经成为App标配的时候。我们经常还会碰到的情况是:软键盘是由WebView中的网页元素所触发弹出的。
情况描写叙述
这时候,情况就会变得复杂了:
- 首先,页面是
非全屏模式
的情况下,给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
模式。
那么躲坑的姿势就非常easy了——
假设activity中有WebView,就不要使用全屏模式
,并且把它的windowSoftInputMode值设为adjustResize
就好了嘛
怎么样。是不是非常easy?��
填坑姿势
但总有些时候,是须要全屏模式
跟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 visible
frameLayoutParams.height = usableHeightSansKeyboard - heightDifference;
} else {
// keyboard probably just became hidden
frameLayoutParams.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是弹窗、或者7.0以后的分屏样式等,android.R.id.content也是弹窗的范围或者分屏所在的半个屏幕——这些情况较少,就暂且不考虑了。
我们经经常使用的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可视状态有变化时,进行通知回调。
——『软键盘弹出』,则是会触发这个事件的一个源。 (软键盘弹出会使GlobalLayout发生变化)
也就是说,现在能监听到『软键盘弹出』的事件了。
3.界面变化之后,获取”可用高度”
当软键盘弹出了之后,接下来的事情是获取改变之后的界面的可用高度
(能够被开发人员用以显示内容的高度)。
直接看代码:
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.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 visible
frameLayoutParams.height = usableHeightSansKeyboard - heightDifference;
} else {
// keyboard probably just became hidden
frameLayoutParams.height = usableHeightSansKeyboard;
}
mChildOfContent.requestLayout();
usableHeightPrevious = usableHeightNow;
}
}
上面的代码里加入了一个”heightDifference > (usableHeightSansKeyboard/4)”的推断,这是为了去除无谓的干扰。
由于能触发OnGlobalLayout事件的原因有非常多。不止是软键盘的弹出变化,还包含各种子View的隐藏显示变化等,它们对界面高度的影响有限。加上了这个推断之后,仅仅有界面的高度变化超过1/4的屏幕高度。才会进行又一次设置高度,基本能保证代码仅仅响应软键盘的弹出。
总结
总结起来,就是这样:
- 普通Activity(不带WebView),直接使用
adjustpan
或者adjustResize
- 假设带WebView:
- a) 假设非
全屏模式
,能够使用adjustResize
- b) 假设是
全屏模式
。则使用AndroidBug5497Workaround
进行处理。
- a) 假设非
OK,以上就是一段关于『软键盘挡住输入框』的爬坑之旅。
实用的链接:
https://code.google.com/p/android/issues/detail?id=5497
http://*.com/a/19494006
https://developer.android.com/reference/android/view/ViewTreeObserver.html
关于作者 :
http://www.barryzhang.com
https://barryhappy.github.io