移動端軟鍵盤兼容方案

 

轉自：https://segmentfault.com/a/1190000018959389

前言

最近一段時間在作 H5 聊天項目，踩過其中一大坑：輸入框獲取焦點，軟鍵盤彈起，要求輸入框吸附（或頂）在輸入法框上。需求很明確，看似很簡單，其實否則。從實驗過一些機型上看，發現主要存在如下問題：

• 在 Android 和 IOS 上，獲知軟鍵盤彈起和收起狀態存在差別，且頁面 webview 表現不一樣。
• 在IOS12 上，微信版本 v6.7.4 及以上，輸入框獲取焦點，鍵盤彈起，頁面（webview）總體往上滾動，當鍵盤收起後，不回到原位，致使鍵盤原來所在位置是空白的。
• 在 IOS 上，使用第三方輸入法，高度計算存在誤差，致使在有些輸入法彈起，將輸入框擋住一部分。
• 在有些瀏覽器上使用一些操做技巧，仍是存在輸入框被輸入法遮擋。

下面就上述發現的問題，逐個探索一下解決方案。

獲知軟鍵盤彈起和收起狀態

獲知軟鍵盤的彈起仍是收起狀態很重要，後面的兼容處理都要以此爲前提。然而，H5 並無直接監聽軟鍵盤的原生事件，只能經過軟鍵盤彈起或收起，引起頁面其餘方面的表現間接監聽，曲線救國。而且，在 IOS 和 Android 上的表現不盡相同。

IOS 軟鍵盤彈起表現

在 IOS 上，輸入框（input、textarea 或 富文本）獲取焦點，鍵盤彈起，頁面（webview）並無被壓縮，或者說高度（height）沒有改變，只是頁面（webview）總體往上滾了，且最大滾動高度（scrollTop）爲軟鍵盤高度。

Android 軟鍵盤彈起表現

一樣，在 Android 上，輸入框獲取焦點，鍵盤彈起，可是頁面（webview）高度會發生改變，通常來講，高度爲可視區高度（原高度減去軟鍵盤高度），除了由於頁面內容被撐開能夠產生滾動，webview 自己不能滾動。

IOS 軟鍵盤收起表現

觸發軟鍵盤上的「收起」按鈕鍵盤或者輸入框之外的頁面區域時，輸入框失去焦點，軟鍵盤收起。

Android 軟鍵盤收起表現

觸發輸入框之外的區域時，輸入框失去焦點，軟鍵盤收起。可是，觸發鍵盤上的收起按鈕鍵盤時，輸入框並不會失去焦點，一樣軟鍵盤收起。

 

監聽軟鍵盤彈起和收起

綜合上面鍵盤彈起和收起在 IOS 和 Android 上的不一樣表現，咱們能夠分開進行以下處理來監聽軟鍵盤的彈起和收起：

• 在 IOS 上，監聽輸入框的 focus 事件來獲知軟鍵盤彈起，監聽輸入框的 blur 事件獲知軟鍵盤收起。
• 在 Android 上，監聽 webview 高度會變化，高度變小獲知軟鍵盤彈起，不然軟鍵盤收起。

// 判斷設備類型 var judgeDeviceType = function () { var ua = window.navigator.userAgent.toLocaleLowerCase(); var isIOS = /iphone|ipad|ipod/.test(ua); var isAndroid = /android/.test(ua); return { isIOS: isIOS, isAndroid: isAndroid } }() // 監聽輸入框的軟鍵盤彈起和收起事件 function listenKeybord($input) { if (judgeDeviceType.isIOS) { // IOS 鍵盤彈起：IOS 和 Android 輸入框獲取焦點鍵盤彈起 $input.addEventListener('focus', function () { console.log('IOS 鍵盤彈起啦！'); // IOS 鍵盤彈起後操做 }, false) // IOS 鍵盤收起：IOS 點擊輸入框之外區域或點擊收起按鈕，輸入框都會失去焦點，鍵盤會收起， $input.addEventListener('blur', () => { console.log('IOS 鍵盤收起啦！'); // IOS 鍵盤收起後操做 }) } // Andriod 鍵盤收起：Andriod 鍵盤彈起或收起頁面高度會發生變化，以此爲依據獲知鍵盤收起 if (judgeDeviceType.isAndroid) { var originHeight = document.documentElement.clientHeight || document.body.clientHeight; window.addEventListener('resize', function () { var resizeHeight = document.documentElement.clientHeight || document.body.clientHeight; if (originHeight < resizeHeight) { console.log('Android 鍵盤收起啦！'); // Android 鍵盤收起後操做 } else { console.log('Android 鍵盤彈起啦！'); // Android 鍵盤彈起後操做 } originHeight = resizeHeight; }, false) } } var $inputs = document.querySelectorAll('.input'); for (var i = 0; i < $inputs.length; i++) { listenKeybord($inputs[i]); }

彈起軟鍵盤始終讓輸入框滾動到可視區

有時咱們會作一個輸入表單，有不少輸入項，輸入框獲取焦點，彈起軟鍵盤。當輸入框位於頁面下部位置時，在 IOS 上，會將 webview 總體往上滾一段距離，使得該獲取焦點的輸入框自動處於可視區，而在 Android 則不會這樣，它只會改變頁面高度，而不會去滾動到當前焦點元素到可視區。
因爲上面已經實現監聽 IOS 和 Android 鍵盤彈起和收起，在這裏，只需在 Android 鍵盤彈起後，將焦點元素滾動（scrollIntoView()）到可視區。查看效果，能夠戳這裏。

// 獲取到焦點元素滾動到可視區 function activeElementScrollIntoView(activeElement, delay) { var editable = activeElement.getAttribute('contenteditable') // 輸入框、textarea或富文本獲取焦點後沒有將該元素滾動到可視區 if (activeElement.tagName == 'INPUT' || activeElement.tagName == 'TEXTAREA' || editable === '' || editable) { setTimeout(function () { activeElement.scrollIntoView(); }, delay) } } // ... // Android 鍵盤彈起後操做 activeElementScrollIntoView($input, 1000); // ...

喚起純數字軟鍵盤

上面的表單輸入框有要求輸入電話號碼，相似這樣就要彈出一個數字軟鍵盤了，既然說到了軟鍵盤兼容，在這裏就安插一下。比較好的解決方案以下：

<p>請輸入手機號</p> <input type="tel" novalidate="novalidate" pattern="[0-9]*" class="input">

• type="tel"， 是 HTML5 的一個屬性，表示輸入框類型爲電話號碼，在 Android 和 IOS 上表現差很少，都會有數字鍵盤，可是也會有字母，略顯多餘。
• pattern="[0-9]"， pattern 用於驗證表單輸入的內容，一般 HTML5 的 type 屬性，好比 email、tel、number、data 類、url 等，已經自帶了簡單的數據格式驗證功能了，加上 pattern 後，前端部分的驗證更加簡單高效了。IOS 中，只有 [0-9]\* 才能夠調起九宮格數字鍵盤，\d 無效，Android 4.4 如下（包括X5內核），二者都調起數字鍵盤。
• novalidate="novalidate"，novalidate 屬性規定當提交表單時不對其進行驗證，因爲 pattern 校驗兼容性很差，能夠不讓其校驗，只讓其喚起純數字鍵盤，校驗工做由 js 去作。

•  

兼容 IOS12 + V6.7.4+

若是你在用 IOS12 和 V6.7.4+版本的微信瀏覽器打開上面表單輸入的 demo ，就會驚奇的發現鍵盤收起後，本來被滾動頂起的頁面並無回到底部位置，致使原來鍵盤彈起的位置「空」了。

 

其實這是 Apple 在 IOS 的 bug，會出如今全部的 Xcode10 打包的 IOS12 的設備上。微信官方已給出解決方案，只需在軟鍵盤收起後，將頁面（webview）滾回到窗口最底部位置（clientHeight位置）。修復後的上面表單輸入 demo 能夠戳這裏

console.log('IOS 鍵盤收起啦！'); // IOS 鍵盤收起後操做 // 微信瀏覽器版本6.7.4+IOS12會出現鍵盤收起後，視圖被頂上去了沒有下來 var wechatInfo = window.navigator.userAgent.match(/MicroMessenger\/([\d\.]+)/i); if (!wechatInfo) return; var wechatVersion = wechatInfo[1]; var version = (navigator.appVersion).match(/OS (\d+)_(\d+)_?(\d+)?/); if (+wechatVersion.replace(/\./g, '') >= 674 && +version[1] >= 12) { window.scrollTo(0, Math.max(document.body.clientHeight, document.documentElement.clientHeight)); } 

兼容第三方輸入法

上面說了那麼多，其實已經把 H5 聊天輸入框的坑填了一大半了，接下來就先看下聊天輸入框的基本HTML結構

<div class="chat__content"> <div> <p>一些聊天內容1</p> </div> <!-- 省略幾千行聊天內容 --> </div> <div class="input__content"> <div class="input" contenteditable="true"></div> <button>發送</button> </div>

樣式

/* 省略一些樣式 */ .chat__content { height: calc(100% - 40px); margin-bottom: 40px; overflow-y: auto; overflow-x: hidden; } .input__content { display: flex; height: 40px; position: absolute; left: 0; right: 0; bottom: 0; align-items: center; } /* 省略一些樣式 */

很簡單，就是劃份內容區和輸入區，輸入區是絕對定位，按照上面表單輸入 demo 的作法，確實大部分 Android 瀏覽器是沒問題的，可是測試在 IOS 上，UC 瀏覽器配合原生輸入法和第三方輸入法（好比搜狗輸入法），輸入框都會被徹底擋住；QQ 瀏覽器或微信瀏覽器，配合第三方輸入法，輸入框會被遮住一半；百度瀏覽器配合第三方輸入法輸入框也會被徹底遮住。查看效果能夠用相應瀏覽器中訪問這裏。

 

在 UC 瀏覽器上，軟鍵盤彈起後，瀏覽器上面的標題欄高度就有個高度變小延時動態效果，這樣致使 webview 往下滾了一點，底部輸入框滾到了非可視區。
而對於第三方輸入法，猜想自己是因爲輸入法面板彈起後高度計算有誤，致使 webview 初始滾動定位有誤。其實這兩點都是 webview 滾動不到位形成的。可讓軟鍵盤彈起後，讓焦點元素再次滾到可視區，強迫 webview 滾到位。

console.log('Android 鍵盤彈起啦！'); // Android 鍵盤彈起後操做 activeElementScrollIntoView($input, 1000);

兼容 Android 小米瀏覽器的 Hack 方案

在 Android 的小米瀏覽器上，應用上面的方案，發現聊天輸入框仍是被遮擋得嚴嚴實實，scrollIntoView() 仍然紋絲不動。因此猜想，實際上是滾到底了，軟鍵盤彈起，頁面實現高度大於可視區高度，這樣只能在軟鍵盤彈起後，強行增長頁面高度，使輸入框能夠顯示出來。綜合上面兼容第三方輸入法，查看效果能夠戳這裏

// Andriod 鍵盤收起：Andriod 鍵盤彈起或收起頁面高度會發生變化，以此爲依據獲知鍵盤收起 if (judgeDeviceType.isAndroid) { var originHeight = document.documentElement.clientHeight || document.body.clientHeight; window.addEventListener('resize', function () { var resizeHeight = document.documentElement.clientHeight || document.body.clientHeight; if (originHeight < resizeHeight) { console.log('Android 鍵盤收起啦！'); // Android 鍵盤收起後操做 // 修復小米瀏覽器下，輸入框依舊被輸入法遮擋問題 if (judgeDeviceType.isMiuiBrowser) { document.body.style.marginBottom = '0px'; } } else { console.log('Android 鍵盤彈起啦！'); // Android 鍵盤彈起後操做 // 修復小米瀏覽器下，輸入框依舊被輸入法遮擋問題 if (judgeDeviceType.isMiuiBrowser) { document.body.style.marginBottom = '40px'; } activeElementScrollIntoView($input, 1000); } originHeight = resizeHeight; }, false) }

總結

H5 端前路漫漫，坑不少，須要不斷嘗試。瞭解軟鍵盤彈起頁面在 IOS 和 Android 上的表現差別是前提，其次是將焦點元素滾動到可視區，同時要考慮到第三方輸入法和某些瀏覽器上的差異。總結確定不全面，歡迎你們指正哈，完~