h5手機鍵盤彈出收起的處理


前言:

前端時間也是應項目的需求開始了h5移動端的折騰之旅,在目前中台的基礎上擴展了兩個ToC移動端項目,下面就是在h5移動端表單頁面鍵盤彈出收起兼容性的一些總結。  

 

問題

在 h5 項目中,我們會經常遇到一些表單頁面,在輸入框獲取焦點時,會自動觸發鍵盤彈起,而鍵盤彈出在 IOS 與 Android 的 webview 中表現並非一致,同時當我們主動觸發鍵盤收起時也同樣存在差異化。

鍵盤彈出

  • IOS:IOS系統 的鍵盤處在窗口的最上層,當鍵盤彈起時,webview 的高度 height 並沒有改變,只是 scrollTop 發生變化,頁面可以滾動。且頁面可以滾動的最大限度為彈出的鍵盤的高度,而只有鍵盤彈出時頁面恰好也滾動到最底部時,scrollTop 的變化值為鍵盤的高度,其他情況下則無法獲取。這就導致在 IOS 情況下難以獲取鍵盤的真實高度。
  • Android: 在Android系統中,鍵盤也是處在窗口的最上層,鍵盤彈起時,如果輸入框在靠近底部的話,就會被鍵盤擋住,只有你輸入的時候輸入框才會滾動到可視化區域。

鍵盤收起

  • IOS:觸發鍵盤上的按鈕收起鍵盤或者輸入框以外的頁面區域時,輸入框會失去焦點,因此會觸發輸入框的 blur 事件;當鍵盤收起時,頁面底部會出現一個空白區域,頁面會被頂起。
  • Android: 觸發鍵盤上的按鈕收起鍵盤時,輸入框並不會失去焦點,因此不會觸發頁面的 blur 事件;觸發輸入框以外的區域時,輸入框會失去焦點,觸發輸入框的 blur 事件。

 

期望的結果

針對不同系統觸發鍵盤彈出收起時的差異化,我們希望功能流暢的同時,盡量保持用戶體驗的一致性。

 

對症下葯

上面我們理清了目前市面上兩大主要系統的差異性,接下來就需對症下葯了。

在 h5 中目前沒有接口可以直接監聽鍵盤事件,但我們可以通過分析鍵盤彈出、收起的觸發過程及表現形式,來判斷鍵盤是彈出還是收起的狀態。

  • 鍵盤彈出:輸入框獲取焦點時會自動觸發鍵盤的彈起動作,因此,我們可以監聽 focusin 事件,在里面實現鍵盤彈出后所需的頁面邏輯。
  • 鍵盤收起:當觸發其他頁面區域收起鍵盤時,我們可以監聽 focusout 事件,在里面實現鍵盤收起后所需的頁面邏輯。而在通過鍵盤按鈕收起鍵盤時在 ios 與 android 端存在差異化表現,下面具體分析:

    • IOS:觸發了 focusout 事件,仍然通過該辦法監聽。
    • Android:沒有觸發 focusout 事件。在 android 中,鍵盤的狀態切換(彈出、收起)不僅和輸入框關聯,同時還會影響到 webview 高度的變化,那我們就可以通過監聽 webview height 的變化來判斷鍵盤是否收起。

系統判斷

在實踐中我們可以通過 userAgent 來判斷目前的系統:

const ua = window.navigator.userAgent.toLocaleLowerCase(); const isIOS = /iphone|ipad|ipod/.test(ua); const isAndroid = /android/.test(ua);

 

IOS 處理

let isReset = true; //是否歸位 this.focusinHandler = () => { isReset = false; //聚焦時鍵盤彈出,焦點在輸入框之間切換時,會先觸發上一個輸入框的失焦事件,再觸發下一個輸入框的聚焦事件 }; this.focusoutHandler = () => { isReset = true; setTimeout(() => { //當焦點在彈出層的輸入框之間切換時先不歸位 if (isReset) { window.scroll(0, 0); //確定延時后沒有聚焦下一元素,是由收起鍵盤引起的失焦,則強制讓頁面歸位 } }, 30); }; document.body.addEventListener('focusin', this.focusinHandler); document.body.addEventListener('focusout', this.focusoutHandler);

 

Android 處理

const originHeight = document.documentElement.clientHeight || document.body.clientHeight; this.resizeHandler = () => { const resizeHeight = document.documentElement.clientHeight || document.body.clientHeight; const activeElement = document.activeElement; if (resizeHeight < originHeight) { // 鍵盤彈起后邏輯 if (activeElement && (activeElement.tagName === "INPUT" || activeElement.tagName === "TEXTAREA")) { setTimeout(()=>{ activeElement.scrollIntoView({ block: 'center' });//焦點元素滾到可視區域的問題 },0) } } else { // 鍵盤收起后邏輯 } }; window.addEventListener('resize', this.resizeHandler);

 

react 封裝

在 react 中我們可以寫一個類裝飾器來修飾表單組件。

類裝飾器:類裝飾器在類聲明之前被聲明(緊靠着類聲明)。 類裝飾器應用於類構造函數,可以用來監視,修改或替換類定義。
// keyboard.tsx /* * @Description: 鍵盤處理裝飾器 * @Author: hzzly * @LastEditors: hzzly * @Date: 2020-01-09 09:36:40 * @LastEditTime: 2020-01-10 12:08:47 */ import React, { Component } from 'react'; const keyboard = () => (WrappedComponent: any) => class HOC extends Component { focusinHandler: (() => void) | undefined; focusoutHandler: (() => void) | undefined; resizeHandler: (() => void) | undefined; componentDidMount() { const ua = window.navigator.userAgent.toLocaleLowerCase(); const isIOS = /iphone|ipad|ipod/.test(ua); const isAndroid = /android/.test(ua); if (isIOS) { // 上面 IOS 處理 ... } if (isAndroid) { // 上面 Android 處理 ... } } componentWillUnmount() { if (this.focusinHandler && this.focusoutHandler) { document.body.removeEventListener('focusin', this.focusinHandler); document.body.removeEventListener('focusout', this.focusoutHandler); } if (this.resizeHandler) { document.body.removeEventListener('resize', this.resizeHandler); } } render() { return <WrappedComponent {...this.props} />; } }; export default keyboard;

豌豆資源搜索網站https://55wd.com 廣州vi設計公司http://www.maiqicn.com

使用

// PersonForm.tsx @keyboard() class PersonForm extends PureComponent<{}, {}> { // 業務邏輯 ... } export default PersonForm;


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM