H5軟鍵盤兼容方案

可能這些是你想要的H5軟鍵盤兼容方案

最近一段時間在作 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 上的表現差別是前提，其次是將焦點元素滾動到可視區，同時要考慮到第三方輸入法和某些瀏覽器上的差異。總結確定不全面，歡迎你們指正哈，完~

做者：wuwhshttps://segmentfault.com/a/1190000018959389