H5 移动端 键盘遮挡焦点元素解决方案
前言
最近在做 webapp,遇到了很多移动端兼容的问题,其中一个问题就是:输入框触发 focus 后,键盘弹出,然后遮住了输入框。
然后在Android
和IOS
上,这个问题的表现形式不一样,而原生键盘和第三方键盘也不一样,但引起的问题都是一样的:输入框被遮住了。
需要的效果
在键盘弹出时,获得焦点的输入框要在可视区域内,效果如下图:
键盘弹出、收起的表现
-
IOS:
输入框获取焦点,键盘弹出,
webview
高度不会改变,但webview
会往上滚,且最大滚动高度scrollTop
为键盘高度。点击键盘上的收起按钮,或者输入框以外的页面区域时,输入框失去焦点,键盘收起。
-
Android:
输入框获取焦点,键盘弹出,但是
webview
高度会发生改变,高度为原高度减去软键盘高度。点击输入框以外的区域时,输入框失去焦点,软键盘收起。而点击键盘上的收起按钮时,键盘收起 ,但输入框并不会失去焦点,坑。
解决方案
当输入框被挡住,在IOS
中,webview
会往上滚一段距离,使得获取焦点的输入框自动处于可视区,而在Android
里,只会改变webview
高度,而不会发生焦点元素滚动到可视区的事情。
所以IOS
可以不用管,而Android
需要在键盘弹出的时候,将输入框滚动到可视区。
获取设备类型
首先是要获取设备类型,通过navigator.userAgent
获取即可。
const judgeDeviceType = (() => {
let deviceType = null;
return () => {
if (!deviceType) {
const ua = window.navigator.userAgent.toLocaleLowerCase();
const isIOS = /iphone|ipad|ipod/.test(ua);
const isAndroid = /android/.test(ua);
const isMiuiBrowser = /miuibrowser/.test(ua);
deviceType = {
isIOS: isIOS,
isAndroid: isAndroid,
isMiuiBrowser: isMiuiBrowser
};
}
return deviceType;
};
})();
监听事件
IOS 可以通过focus
和blur
事件监听键盘弹出、收起,但 Android 不行,但因为webview
高度会变,所以通过监听resize
事件解决。
export function listenAndroidKeybord() {
const { isAndroid } = judgeDeviceType();
if (isAndroid) {
const androidResize = function() {
// 将当前焦点元素滚动到可视区
activeElementScrollIntoView();
};
// android 键盘弹出、收起,可视区高度会发生变化
window.addEventListener('resize', androidResize, false);
return () => {
window.removeEventListener('resize', androidResize, false);
};
}
}
将元素滚动到可视区
要将元素滚动到可视区,主要有两个方法:scrollIntoView
和scrollIntoViewIfNeeded
,兼容性在移动端都很不错。
function activeElementScrollIntoView() {
const activeEl = document.activeElement;
if (
activeEl.tagName === 'INPUT' ||
activeEl.tagName === 'TEXTAREA'
) {
window.setTimeout(() => {
if ('scrollIntoView' in activeEl) {
activeElt.scrollIntoView();
} else {
activeEl.scrollIntoViewIfNeeded();
}
}, 100);
}
}
MiuiBrowser
以上代码可以说解决了大部分浏览器键盘遮挡问题了,但我用自己的小米手机自带的小米浏览器测试时,出了问题,键盘弹出,页面纹丝不动,手动去拖,有时行,有时不行。
搞了很久,发现了两个问题,我这手机上自带的小米浏览器,userAgent 上没有带Android
标识,但有MiuiBrowser
标识,坑。然后,页面有时能拖动,有时不能拖动,我猜应该是webview
的可视区高度变化有问题,或者是我的代码监听resize
导致有问题。
解决方案
-
增加设备类型判断
const ua = window.navigator.userAgent.toLocaleLowerCase(); const isMiuiBrowser = /miuibrowser/.test(ua);
-
通过监听
focus
和blur
事件来监听键盘弹出、收起,然后给body
加高度body, html { height: 100%; }
function listenMiuiBrowserKeybord() { const { isMiuiBrowser } = judgeDeviceType(); if (isMiuiBrowser) { const inputFocus = function() { document.body.style.marginBottom = '50px'; activeElementScrollIntoView(); }; const inputBlur = function() { document.body.style.marginBottom = '0px'; activeElementScrollIntoView(); }; let $inputs = document.getElementsByTagName('input'); for (let i = 0; i < $inputs.length; i++) { $inputs[i].addEventListener('focus', inputFocus, false); $inputs[i].addEventListener('blur', inputBlur, false); } return () => { for (let i = 0; i < $inputs.length; i++) { $inputs[i].removeEventListener('focus', inputFocus, false); $inputs[i].removeEventListener('blur', inputBlur, false); } }; } }
坑点:这种方案虽然解决了弹出问题,但点击键盘收起按钮,Android 下输入框并不会失去焦点,需要失去焦点才能让 body 增加的高度变为 0。
备注
解决方案并不完善,踩坑路漫漫。