Android 的输入法适配设置windowSoftInputMode的9种方式

原创最新推荐文章于 2026-09-20 14:22:09 发布 1.1w 阅读 AI写同款

收录于

Android 开发点滴

Android FrameWork

千雅爸爸

码龄18年墨衍会员 · AI 创作全网分发

292粉丝639篇原创

关注

Java代码动态设置SoftInputMode，友好进行底部界面呈现获取软键盘的高度代码切换SoftInputMode 附件与软键盘友好切换阅读详情

AI摘要

本文详细介绍了Android中`android:windowSoftInputMode`属性的使用，包括`adjust`系列和`state`系列的属性值，如`adjustPan`、`adjustResize`、`stateVisible`等，解析了它们在不同场景下的效果，帮助开发者更好地控制软键盘与Activity窗口的交互行为。

实现接口

用户评论开发过程中通常需要和EditText控件打交道，编辑框通常编程过程中最常见的就是和软键盘做交互操作。在用户最初进入编辑评论时有时希望直接展示软键盘，减少用户选中输入框操作，最好是保证输入框不被软件盘覆盖住。android:windowSoftInputMode属性就包含了实现这些交互方式的属性，主要分成两个部分，一个是控制软件盘展示或隐藏的state开头属性值，一个是控制展示输入框的Window适配效果的adjust开头属性值，通常都是两个使用或（|）指定键盘盘和Windwo适配效果，最常见的Adjust属性值解释如下：

属性值   意义
adjustPan   如果Window内容布局可以滚动，尽量将输入框展示在软件盘之上，不能保证软件盘没有遮盖其他内容布局
adjustResize   Window内容布局整体压缩，展示软件盘的地方不会展示内容布局
adjustNothing   Window布局不做任何调整
adjustUnspecified   根据情况做adjustPan或者adjustResize
控制软件盘展示交互的state属性如下：

属性值   意义
stateVisible   初次进入界面展示软键盘
stateAlwaysVisible   不管是初次进入还是导航到别的Activity重新回来，都展示软件盘
stateHide   初次键入不展示软件盘
stateAlwaysHide   不论初次还是从别的Activity导航回来都不展示软件盘
stateUnchanged   软键盘保持在前一个Activity里的状态不论展开还是关闭
stateUnspecified   未指定软键盘状态

adjust开头的都是适配屏幕用的，

state是用来在不同的acitivity 之间切换和初次的时候进入界面的时候用的

1: 默认的不设置的情况，会把这个edittest 推上去，同时会把activity推上去，ajustPan

2: <activity android:name=".MainActivity" android:windowSoftInputMode="adjustNothing">

如果是adjustNothing 的时候，不会把输入框推上去，acitivity 不会推上去

3: <activity android:name=".MainActivity" android:windowSoftInputMode="adjustPan">

adjustPan的话，会把底部的acitivity 也推上去，不会推上去的

4: <activity android:name=".MainActivity" android:windowSoftInputMode="adjustResize">

adjustResize 将edittext 推上去，acitivty 没有推

5: <activity android:name=".MainActivity" android:windowSoftInputMode="adjustUnspecified">

edittext 会推上去，activity 也推上去了

6: <activity android:name=".MainActivity" android:windowSoftInputMode="stateAlwaysVisible">

<activity android:name=".SecondActivity" android:windowSoftInputMode="stateAlwaysVisible"></activity>

当从MainActivity 切换到 SecondActivity的后，一直显示输入法

6: <activity android:name=".MainActivity" android:windowSoftInputMode="stateAlwaysHidden">

7: <activity android:name=".MainActivity" android:windowSoftInputMode="stateHidden">

切换的时候，直接隐藏

顾名思义，假设我们设置了这个属性，那么键盘状态一定是隐藏的，无论上个界面什么状态。也无论当前界面有没有输入的需求，反正就是不显示。因此，我们能够设置这个属性，来控制软键盘不自己主动的弹出。

8:<activity android:name=".MainActivity" android:windowSoftInputMode="stateVisible">

相对于stateAlwaysVisible (不管是初次进入还是导航到别的Activity重新回来，都展示软件盘)

stateVisible 只有初次进去这个界面的时候visible，设置为这个属性，能够将软键盘召唤出来，即使在界面上没有输入框的情况下也能够强制召唤出来。

9: <activity android:name=".MainActivity" android:windowSoftInputMode="stateUnchanged">

中文的意思就是状态不改变的意思。我们应该怎么理解这句话呢？事实上非常好理解，就是说，当前界面的软键盘状态，取决于上一个界面的软键盘状态。举个样例，假如当前界面键盘是隐藏的，那么跳转之后的界面，软键盘也是隐藏的；假设当前界面是显示的，那么跳转之后的界面，软键盘也是显示状态。

例如第一个界面输入法展示出来了，那么跳转到第二个acitivty的时候，输入法也会显示出来

10: <activity android:name=".MainActivity" android:windowSoftInputMode="stateUnspecified">

stateUnspecified

中文意思是未指定状态，当我们没有设置android:windowSoftInputMode属性的时候，软件默认採用的就是这样的交互方式，系统会依据界面採取对应的软键盘的显示模式。比方。当界面上仅仅有文本和button的时候，软键盘就不会自己主动弹出。由于没有输入的必要。

那么。当界面上出现了获取了焦点的输入框的时候。软键盘会不会自己主动的弹出呢？这个还真不一定！

就是说。默认的，在这样的界面情况下，系统并不确定用户是否须要软键盘，因此不会自己主动弹出。

可是，为什么说不一定呢？这是由于，假设我们在这个布局的外面，包裹上一个

ScrollView，软键盘就会自己主动的弹出来了！

其实就是我们安装向下的按钮向下的时候，如果检查到了

例如以下，在这样的布局文件下，软键盘会自己主动的弹出

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical" >

    <ScrollView
        android:layout_width="match_parent"
        android:layout_height="match_parent" >

        <LinearLayout
            android:layout_width="match_parent"
            android:layout_height="wrap_content"
            android:orientation="vertical" >

            <Button
                android:layout_width="match_parent"
                android:layout_height="wrap_content"
                android:onClick="toOther"
                android:text="跳转" />

            <EditText
                android:layout_width="match_parent"
                android:layout_height="wrap_content" />
        </LinearLayout>
    </ScrollView>

</LinearLayout>

这确实是一个非常奇怪的推断方式。因此，我们能够得出结论，当设置属性为stateUnspecified的时候，系统是默认不弹出软键盘的。可是当有获得焦点的输入框的界面有滚动的需求的时候，会自己主动弹出软键盘。至于为什么非要强调要获取焦点的输入框。这是由于，假设不是输入框获取焦点。软键盘也是不会自己主动弹出的。让界面不自己主动弹出软键盘的当中一个解决方式，就是在xml文件里。设置一个非输入框控件获取焦点，从而阻止键盘弹出。

++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

其他可以参考的：

参考；https://blog.youkuaiyun.com/xingzhong128/article/details/79194233

参考：https://www.cnblogs.com/gccbuaa/p/7049889.html

【Android开发经验】android:windowSoftInputMode属性具体解释

本文章来自优快云博客：http://blog.youkuaiyun.com/zhaokaiqiang1992。转载请注明地址！

在前面的一篇文章中，简单的介绍了一下怎样实现软键盘不自己主动弹出，使用的方法是设置android:windowSoftInputMode属性。

那么，这个属性究竟是干什么的，他有什么作用呢？今天这篇文章。就是探索android:windowSoftInputMode属性的作用的。

首先，我们从这个属性的名称中，能够非常直观的看出它的作用，这个属性就是来设置窗体软键盘的交互模式的。

android:windowSoftInputMode属性一共同拥有9个取值。各自是：

stateUnspecified，stateUnchanged。stateHidden，stateAlwaysHidden。stateVisible，stateAlwaysVisible，adjustUnspecified，adjustResize。adjustPan。

我们设置属性的时候。能够在这9个值里面选择一个。也能够用"state...|adjust"的形式进行设置。那么，这些取值究竟是怎么影响到软键盘与窗体之间的交互的呢？以下。我们就一个个的測试这9个取值。究竟是怎样影响软键盘的显示的。

1.stateUnspecified

那么。当界面上出现了获取了焦点的输入框的时候。软键盘会不会自己主动的弹出呢？这个还真不一定！

比方，在以下的这个界面布局中。软键盘并不会自己主动弹出。

就是说。默认的，在这样的界面情况下，系统并不确定用户是否须要软键盘，因此不会自己主动弹出。

可是，为什么说不一定呢？这是由于，假设我们在这个布局的外面，包裹上一个

ScrollView，软键盘就会自己主动的弹出来了！

例如以下，在这样的布局文件下，软键盘会自己主动的弹出

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical" >

    <ScrollView
        android:layout_width="match_parent"
        android:layout_height="match_parent" >

        <LinearLayout
            android:layout_width="match_parent"
            android:layout_height="wrap_content"
            android:orientation="vertical" >

            <Button
                android:layout_width="match_parent"
                android:layout_height="wrap_content"
                android:onClick="toOther"
                android:text="跳转" />

            <EditText
                android:layout_width="match_parent"
                android:layout_height="wrap_content" />
        </LinearLayout>
    </ScrollView>

</LinearLayout>

2.stateUnchanged

3.stateHidden

4.stateAlwaysHidden

这个属性也能够让软键盘隐藏，可是我临时还不知道和stateHidden属性的差别，本来想去stackOverFlow上问一下的，可是，Great Wall，呵呵呵...祝愿病魔早日战胜方校长

5.stateVisible

设置为这个属性，能够将软键盘召唤出来，即使在界面上没有输入框的情况下也能够强制召唤出来。

6.stateAlwaysVisible

这个属性也是能够将键盘召唤出来，可是与stateVisible属性有小小的不同之处。举个样例，当我们设置为stateVisible属性，假设当前的界面键盘是显示的，当我们点击button跳转到下个界面的时候，软键盘会由于输入框失去焦点而隐藏起来，当我们再次回到当前界面的时候，键盘这个时候是隐藏的。可是假设我们设置为stateAlwaysVisible，我们跳转到下个界面，软键盘还是隐藏的，可是当我们再次回来的时候。软键盘是会显示出来的。

所以。这个Always就解释了这个差别，无论什么情况到达当前界面(正常跳转或者是上一个界面被用户返回)。软键盘都是显示状态。

讲到这里。我联想到了上面的stateHidden和stateAlwaysHidden。我预计差别也是这种。就是说。stateAlwaysHidden不管怎样都是隐藏的，可是假设在跳转到下个界面的时候。软键盘被召唤出来了。那么当下个界面被用户返回的时候，键盘应该是不会被隐藏的，可是，我还没有找到可以跳转到下个界面，还让当前界面软键盘不消失的方法。所以临时不能验证。

7.adjustUnspecified

从这个属性開始。就不是设置软键盘的显示与隐藏模式了，而是设置软键盘与软件的显示内容之间的显示关系。当你跟我们没有设置这个值的时候，这个选项也是默认的设置模式。在这中情况下，系统会依据界面选择不同的模式。假设界面里面有能够滚动的控件，比方ScrowView。系统会减小能够滚动的界面的大小，从而保证即使软键盘显示出来了，也能够看到全部的内容。假设布局里面没有滚动的控件。那么软键盘可能就会盖住一些内容，我们从以下的图中能够看出区别。

没有滚动控件，软键盘以下的布局都被遮挡住了，若想改动，仅仅能隐藏软键盘。然后选择。并且，重点注意一下上面的布局，当我们选择的输入框偏下的时候，上面的标题栏和布局被软键盘顶上去了。

记住这个特征，由于后面有个属性和这个的效果不一样。

布局里面有滑动控件，系统会自己主动的缩小整个界面的大小。因此，我们能够软键盘上面的小区域中显示全部的输入框。

这就是两中显示模式之间的区别。

8.adjustResize

这个属性表示Activity的主窗体总是会被调整大小，从而保证软键盘显示空间。

我们先看显示效果。

注意观察这个上面的标题栏和button，设置为adjustResize属性之后，对于没有滑动控件的布局。尽管还是不能选择全部的输入框。可是，窗体的显示方式发生了变化，默认属性时，整个布局是被顶上去了，可是设置为adjustResize属性。布局的位置并没有发生什么变化。这就是最大的差别。

而对于有滑动控件的布局来说，显示效果和默认是一样的。

9.adjustPan

假设设置为这个属性。那么Activity的屏幕大小并不会调整来保证软键盘的空间。而是採取了第二种策略，系统会通过布局的移动，来保证用户要进行输入的输入框肯定在用户的失业范围里面，从而让用户能够看到自己输入的内容。对于没有滚动控件的布局来说。这个事实上就是默认的设置，假设我们选择的位置偏下，上面的标题栏和部分控件会被顶上去。可是对于有滚动控件的布局来说。则不太一样。我们看以下的效果图。

首先，这是软键盘没有弹出的时候，有滚动控件的显示范围。最以下显示的是9.