自适应软键盘的 Dialog 以及基于 Dialog 实现软键盘弹起与收下的监听

4,449 阅读5分钟

最近项目中遇到一个需求:新手引导。跟一般的新手引导没有什么太大区别,思路都是搞一个带阴影的遮罩层,然后在上边儿给一些提示性的文字,由于需求中有些特殊的地方,所以我用了一个全屏的dialog(而且,dialog自带阴影效果)来做新手引导这个需求。


弹出键盘


键盘上方具体位置显示引导

这个需求中有两个地方需要考虑:1. Dialog的布局要适应软键盘的弹起2. 软键盘弹起和收下的时候都会有不同的引导,所以要在Dialog上监听软键盘的弹起。

需求的解决:
一:适应键盘的弹起。
我们知道,在Activity中如果要让布局不被软键盘遮挡,方法一般是在清单文件中配置windowSoftInputMode属性, windowSoftInputMode是Android1.5以后的一个新特性,主要是对软键盘操作的,主要有以下属性:

  1. stateUnspecified:软键盘的状态并没有指定,系统将选择一个合适的状态或依赖于主题的设置
  2. stateUnchanged:当这个activity出现时,软键盘将一直保持在上一个activity里的状态,无论是隐藏还是显示
  3. stateHidden:用户选择activity时,软键盘总是被隐藏
  4. stateAlwaysHidden:当该Activity主窗口获取焦点时,软键盘也总是被隐藏的
  5. stateVisible:软键盘通常是可见的
  6. stateAlwaysVisible:用户选择activity时,软键盘总是显示的状态
  7. adjustUnspecified:默认设置,通常由系统自行决定是隐藏还是显示
  8. adjustResize:该Activity总是调整屏幕的大小以便留出软键盘的空间
  9. adjustPan:当前窗口的内容将自动移动以便当前焦点从不被键盘覆盖和用户能总是看到输入内容的部分

我们可以根据需求在清单文件中配置具体的属性,那么如果软键盘是基于Dialog弹出来的话该怎么办呢?毕竟我们没有清单文件来配置Dialog的属性。其实,在清单中配置的属性本质也是告诉当前界面对软键盘这种情况的处理。windowSoftInputMode的属性如果在清单文件中配置的话是这样写的:
android:windowSoftInputMode="stateHidden|adjustPan"

其实在清单文件中的某些配置,我们在Activity也能配置,在Activity中用代码设置话是这样写的:
getWindow().setSoftInputMode(WindowManager.LayoutParams.SOFT_INPUT_ADJUST_RESIZE | WindowManager.LayoutParams.SOFT_INPUT_STATE_HIDDEN);

聪明的你看到这里可能已经看出来什么了,没错,两种方式的实质就是得到当前的窗口实例,来基于当前窗口设置的。我们来进入源码看一下,首先看getWindow()方法:
public Window getWindow() { return mWindow; }

很简单,得到当前的Window实例,再进入setSoftInputMode这个方法:

public void setSoftInputMode(int mode) { 
    final WindowManager.LayoutParams attrs = getAttributes(); 
    if (mode !=   WindowManager.LayoutParams.SOFT_INPUT_STATE_UNSPECIFIED) 
   {      
   attrs.softInputMode = mode; mHasSoftInputMode = true;
    } else {
   mHasSoftInputMode = false;
   }
  if (mCallback != null) {
      mCallback.onWindowAttributesChanged(attrs); 
   }
 }

这个方法很短逻辑也很清晰,我们可以看到,倒数第三行代码,当窗口属性发生变化的时候,mCallback会回调一个方法执行某些操作,那么这个,mCallback是什么呢?在源码中搜索一下你会找到以下代码和注释:

/** * Set the Callback interface for this window, used to intercept key 
* events and other dynamic operations in the window.
 * * @param callback The desired Callback interface. 
*/ 
public void setCallback(Callback callback) { 
     mCallback = callback;
 }

由注释我们可以看到mCallback是给当前窗口设置的一个回调接口,当窗口发生某些变化的时候可以通过这个回调接口执行某些操作。回到mCallback.onWindowAttributesChanged(attrs)这句代码,首先我们肯定知道,Activity肯定实现了这个接口,那么,还有其他的实现了这个接口吗?找到定义这个接口的地方:
This is called whenever the current window attributes change. public void onWindowAttributesChanged(WindowManager.LayoutParams attrs);

由注释我们也可以清楚的明白这个接口的用途:无论在什么时候都会被调用当窗口属性发生变化。在Android Studio中我们可以点击这个接口定义左边的向上箭头查看接口的实现类,我们发现,dialog也实现了这个接口,那么回到第一个需求,解决方法就简单多了,只需要自定义一个Dialog,然后重写onCreate方法,如下:
protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); getWindow().setSoftInputMode(WindowManager.LayoutParams.SOFT_INPUT_ADJUST_RESIZE | WindowManager.LayoutParams.SOFT_INPUT_STATE_HIDDEN); }
其实跟在Activity中设置是一样的。

二,基于Dialog监听软键盘的弹起和收下:
其实看完第一个需求,我们可能已经猜想到,软键盘也是基于当前窗口的,它的弹起和收下肯定会引起当前窗口布局的属性发生变化,所以解决思路就有了:监听当前布局的变化。我这里是比较布局坐标中的下坐标的,因为如果键盘弹起的话,布局的下坐标肯定会变小。具体代码如下:
@Override public void onLayoutChange(View v, int left, int top, int right, int bottom, int oldLeft, int oldTop, int oldRight, int oldBottom) { if (oldBottom != 0 && bottom != 0 && (oldBottom - bottom > 0)) {//软键盘弹起 doSomethinh.. } else if (oldBottom != 0 && bottom != 0 && (bottom - oldBottom > 0)) {//软件盘关闭 doSomethinh.. } }

onLayoutChange这个方法在窗口布局发生变化的时候会被回调,有兴趣的朋友可以去看下源码,注释很清楚。这个回调方法中参数给我们了改变后view的左上右下的坐标,以及改变前view的坐标。