近期在项目中遇到了,Android软键盘相关的内容困扰了好久,也在这里记录一下,方便查阅:
软键盘的显示调整(WindowSoftInputMode)
该属性有如下图的值,影响两个方面:
1,当Activity成为用户注意的焦点时软键盘的状态(隐藏or可见)。
2,软键盘弹出的时候,主窗口是否进行调整。
以上属性,分为 state和 adjust两种(一般使用的时候也是
stateXXX | adjustXXX
混合使用):
state控制软键盘,显示 or 隐藏
stateUnspecified:不指定软键盘的状态(隐藏or显示),该属性将由系统自行选择(也是默认的状态)。
stateUnchanged:保留状态。当activity发生变化的时候,保留软键盘最后的状态,无论是可见or隐藏。
stateHidden:隐藏软键盘,当用户设置了该属性,不管是否界面有输入需求,键盘都不显示。可以设置该属性,控制刚进入界面的时候,软键盘不弹出。
stateAlwaysHidden:始终隐藏软键盘。
stateVisible:显示软键盘,正常的情况下软键盘可以弹出,即使界面没有输入框的情况下,也可以强制弹出。
stateAlwaysVisible:总是显示软键盘。如果当前activity设置为该属性,那么只要返回到该activity,软键盘就会弹出。区别一下stateVisible如果设置的是这个属性切换回activity软键盘不会总是弹出。
adjust在软键盘弹出的时候,是否需要对activity进行调整
adjustUnspecified:默认属性。让系统自行选择。
adjustResize:始终调整activity的窗口尺寸,来为软键盘腾出空间。
adjustPan:不调整Activity 主窗口的尺寸来为软键盘腾出空间,而是自动平移窗口的内容,以使焦点不被覆盖,用户始终可以看到输入的内容
adjustNothing:软键盘弹出的时候,activity界面不做任何响应。
举例说明
常用的adjust为:
- adjustPan:软键盘弹出,主窗口平移(TranslateY),来适应软键盘的显示。
- adjustResize:当软键盘弹出的时候,会让布局重新绘制,这种一般适应于带有滑动的控制(比如:scrollview中有好多个EditText,当第一个获取焦点的时候,仍可以滑动到最后一个EditText)。
看了好多博客,都说该属性设置的时候,跟控件是否滑动有区别,自己也写了个demo测试了一下,见下面的gif图:
- adjustResize
可以从上图看出,当mode为adjustResize的时候,可以滑动的列表(上图左侧),会调整布局,使得EditText显示到软键盘之上,并且可以滑动。
不可滑动的界面,如果点击下方的EditText,软键盘弹出就会被遮盖。
-adjustPan
从上图可以看出,mode为adjuetPan的时候,可滑动列表无法显示当前获取焦点的EditText以下的内容(例如点击可以滑动的EditText_7,无法下拉看到下面的内容),也就是用户始终可以看到输入的内容。
不可滑动的EditText,也是如此,会将布局向上推,以达到用户可以始终看到的目的。
监听软键盘是否弹出
在项目中有一个需求,就是不能让软键盘覆盖输入的内容。使用以上windowSoftInputMode
实现的方式:
1,获取decorView的高度,跟当前内容的高度比较,如果不一致,就说明软键盘弹出:
/**
* 判断是否软键盘弹出
* @return
*/
private boolean isSoftShowing() {
//获取当前屏幕内容的高度(不会变)
int screenHeight = getWindow().getDecorView().getHeight();
//获取View可见区域的bottom
Rect rect = new Rect();
getWindow().getDecorView().getWindowVisibleDisplayFrame(rect);
LogUtils.d(TAG, "screenHeight = " + screenHeight + " rect.bottom = " + rect.bottom);
return screenHeight - rect.bottom != 0;
}
2,为当前界面的布局,添加一个onLayoutChange
的接口,并将判断逻辑添加到里面,例如:
@Override
public void onLayoutChange(View v, int left, int top, int right, int bottom,
int oldLeft, int oldTop, int oldRight, int oldBottom) {
boolean isShowKeyBoard = isSoftShowing();
LogUtils.d(TAG, "软键盘是否弹出 : " + isShowKeyBoard);
if (isShowKeyBoard) {
mLoginLl.setTranslationY(-100);
} else if (!isShowKeyBoard) {
mLoginLl.setTranslationY(0);
}
}
附上一个在Github上比较使用的EditText