本篇內(nèi)容通過操作軟鍵盤的函數(shù)著手詳細分析了隱藏或者顯示軟鍵盤的實現(xiàn)方法,并且對其中重要的代碼做了詳細分析。
一、開篇
如果有需要用到輸入的地方,通常會有需要自動彈出或者收起軟鍵盤的需求。開篇明義,本文會講講彈出和收起軟鍵盤的一些細節(jié),最終還會從源碼進行分析。
想要操作軟鍵盤,需要使用到 InputMethodManager ,它是一個系統(tǒng)服務,可以使用 Context.getSystemService() 獲取到它。而很多關鍵的邏輯代碼,都是在 InputMethodManagerService 中實現(xiàn)的。
特別說明:本文的所有分析的源碼,都是基于 Android 26 的源碼。
二、操作軟鍵盤
2.1 InputMethodManager
前面提到,想要操作軟鍵盤,需要使用 InputMethodManager ,它是一個系統(tǒng)服務,想要獲取它,可以使用 getSystemService() ,獲取到它。

畢竟是系統(tǒng)服務,使用的時候為了安全,還是要判空,避免空指針。
2.2 顯示軟鍵盤
在 InputMethodManager 中,有兩個方法 showSoftInput() 和 showSoftInputFromInputMethod() ,而實際上,只有 showSoftInput() 是有效的。
它有兩個重載方法,而通常我們會使用它的兩個參數(shù)的方法。

這里我們只需要傳遞兩個參數(shù)。它首先需要一個 View ,使用軟鍵盤就是為了輸入,而輸入就需要有接收輸入內(nèi)容的 View ,這里接收輸入的 View ,最好是一個 EditText(但這不是必須的)。
而第二個參數(shù) flags 就是個標志位,從上面截圖的方法簽名上的文檔上可以看到,它接收 0 或者 SHOW_INPYT_IMPLICIT 兩個參數(shù),但是實際上,它有第三個參數(shù),另外一個是 SHOW_FORCED。

可以看到 1、2 都是有特殊含義的,實際上它們并不影響顯示,只是在隱藏的時候,會有一些限制,這些后面看源碼的時候再說,一般沒有特別需要的話,我們直接傳遞 0 就好了。
現(xiàn)在,簡單總結一下調(diào)用 showSoftInput() 會生效的關鍵點:
1、第一個參數(shù),最好是 EditText 或者它的子類。
考慮到軟鍵盤就是為了輸入,EditText 就是一個接收輸入的控件。而這不是絕對的,如果不是一個 EditText ,就必須要求這個 View 有兩個屬性,分別是:android:focusable="true" 和android:focusableInTouchMode="true"。
2、第一個參數(shù),必須是可獲取焦點的,并且當前已經(jīng)獲取到焦點。
EditText 默認是允許獲取焦點的,但是假如布局中,存在多個可獲取焦點的控件,就需要提前讓我們傳遞進去的 View 獲取到焦點。獲取焦點可以使用 requestFocus() 方法。
3、布局必須加載完成。
在 onCreate() 中,如果立即調(diào)用 showSoftInput() 是不會生效的。想要在頁面一啟動的時候就彈出鍵盤,可以在 Activity 上,設置 android:windowSoftInputMode 屬性來完成,或者做一個延遲加載,View.postDelayed() 也是一個解決方案。
所以最終,完整的顯示軟鍵盤的代碼就如下所示了。

2.3 隱藏軟鍵盤
雖然 showSoftInput() 方法是有效的,但是想要隱藏軟鍵盤,就沒有提供對應的 hideSoftInput() 方法,但是卻有一個 hideSoftInputFromWindow() 方法,可以用來隱藏軟鍵盤。
先來看看這個方法的簽名,它同樣有兩個方法可以調(diào)用。

它接收兩個參數(shù),第一個參數(shù)是一個 IBinder ,可以直接傳遞一個 View.getWindowToken() 的 windowToken 對象就可以了。而第二個參數(shù),就是隱藏軟鍵盤的標志位,如果沒有特殊要求的話,直接傳遞 0 就好了。
注意這里雖然原則上需要傳遞一個之前彈出鍵盤傳遞的時候,傳遞的 View 的 windowToken ,但是實際情況是你只需要傳遞一個存在于當前布局 ViewTree 中,隨意一個 View 的 windowToken 就可以了。
最終隱藏軟件的代碼就是這樣的。

2.4 切換鍵盤的彈出和隱藏
在 InputMethodManager 中,還提供了一個 toggleSoftInput() 方法,如同它的名字一樣,它可以讓軟鍵盤在顯示和隱藏之間切換。

該方法,接收兩個 flags ,分別是控制 show 和 hide 時候的標識,它們的含義和前面介紹的 showSoftInput() 和 hideSoftInputFromWindow() 一致,所以沒有特殊要求,直接傳遞 0 就好了。
toggleSoftInput() 方法不要求傳遞一個 View 或者 windowToken,所以它并沒有 showSoftInput() 中的一些限制,但是依然還有需要在布局繪制完成之后調(diào)用才會有效果。

雖然這個方法,限制很少,但是我們基本上不會使用它。主要原因在于,它是一個開關的方法,會根據(jù)當前的狀態(tài)做相反的操作。這就導致很多時候,我們在代碼中,無法直接根據(jù) InputMethodManager 提供的方法判斷當前軟鍵盤的顯示狀態(tài),這樣也就無法確定調(diào)用它的時候的效果了。
三、源碼分析
3.1 flag 的細節(jié)
前面的一些方法,都需要傳遞一個 flag 值,文檔中描述的并不詳細,我們就從源碼的角度,來分析一下這些 flag 的含義。
先來看看 showSoftInput() 方法。

它最終會調(diào)用 mService.showSoftInput() 方法,最終的源碼,就需要查看 InputMethodManagerService 中的代碼了。而 showSoftInput() 方法,最終會調(diào)用 showCurrentInputLocked()。
可以看到,flag 會影響兩個字段,mShowExplicitlyRequested 和 mShowForced,而 SHOW_FORCED 會更強勢一點。
hideSoftInputFromWindow() 方法,最終也會調(diào)用 InputMethodManagerService 中的 hideCurrentInputLocked() 方法。

從 DEBUG == true 會輸出的 Log 中,已經(jīng)可以看到含義了。這里會根據(jù)顯示和隱藏傳遞的兩個 flag 來進行比對,也就是說,如果 flag 使用不正確,可能導致這里直接返回 false ,從而無法隱藏軟鍵盤,這些細節(jié)對照代碼就清晰了,就不在文章里屢這些細節(jié)了。
所以這就是為什么前面提到,如果沒有特殊要求,直接傳遞 0 就好了,可以規(guī)避這個限制。
3.2 如何判斷軟鍵盤是否彈出
既然 toggleSoftInput() 可以根據(jù)當前軟鍵盤的狀態(tài),進行不同的操作,那么肯定是有辦法確定當前軟鍵盤的狀態(tài)的。
那我們繼續(xù)追蹤 toggleSoftInput() 的方法源碼。
該方法,最終會調(diào)用到 InputMethodService 的 onToggleSoftInput() 方法。

在這個方法中,是根據(jù) isInputViewShow() 方法來判定當前軟鍵盤是否處于顯示彈出的狀態(tài)。但是我們并沒有辦法,直接和 InputMethodService 進行交互,我們也就沒辦法直接拿到當前鍵盤是否顯示。
如果想要監(jiān)聽鍵盤的彈出和收起,可以使用 ViewTreeObserver.OnGlobalLayoutListener 這個監(jiān)聽,來監(jiān)聽布局的調(diào)整,從而判斷出鍵盤的彈出和隱藏。這些細節(jié)有時間再聊。
四、KeyboardUtils
既然已經(jīng)清楚了軟鍵盤的收起和彈出的方法細節(jié),那我們來寫一個幫助類,來解決這個問題。讓你們拿到就可用。
這里提供一下 Java 版和 Kotlin 版。
4.1 Java 版
public class KeyboardUtils { public static void showKeyboard(View view) { InputMethodManager imm = (InputMethodManager) view.getContext() .getSystemService(Context.INPUT_METHOD_SERVICE); if (imm != null) { view.requestFocus(); imm.showSoftInput(view, 0); } } public static void hideKeyboard(View view){ InputMethodManager imm = (InputMethodManager) view.getContext() .getSystemService(Context.INPUT_METHOD_SERVICE); if (imm != null) { imm.hideSoftInputFromWindow(view.getWindowToken(),0); } } public static void toggleSoftInput(View view){ InputMethodManager imm = (InputMethodManager) view.getContext() .getSystemService(Context.INPUT_METHOD_SERVICE); if (imm != null) { imm.toggleSoftInput(0,0); } }}
4.2 Kotlin 版
object KeyboardktUtils{ fun showKeyboard(view: View) { val imm = view.context .getSystemService(Context.INPUT_METHOD_SERVICE) as InputMethodManager if (imm != null) { view.requestFocus() imm.showSoftInput(view, 0) } } fun hideKeyboard(view: View) { val imm = view.context .getSystemService(Context.INPUT_METHOD_SERVICE) as InputMethodManager imm?.hideSoftInputFromWindow(view.windowToken, 0) } fun toggleSoftInput(view: View) { val imm = view.context .getSystemService(Context.INPUT_METHOD_SERVICE) as InputMethodManager imm?.toggleSoftInput(0, 0) }}以上就是本文的全部內(nèi)容,如果大家學習了以后還有任何不明白的地方,可以在下方的留言區(qū)進行討論。
新聞熱點
疑難解答
圖片精選