移动端H5开发的坑

HTML 方向

调用系统功能

<!-- 拨打电话 -->
<a href="tel:10086">拨打电话给10086小姐姐</a>

<!-- 发送短信 -->
<a href="sms:10086">发送短信给10086小姐姐</a>

<!-- 发送邮件 -->
<a href="mailto:young.joway@aliyun.com">发送邮件给JowayYoung</a>

<!-- 选择照片或拍摄照片 -->
<input type="file" accept="image/*" />

<!-- 选择视频或拍摄视频 -->
<input type="file" accept="video/*" />

<!-- 多选文件 -->
<input type="file" multiple />

忽略自动识别

有些移动端浏览器会自动将数字字母符号识别为电话/邮箱并将其渲染成上述调用系统功能里的。虽然很方便却有可能违背需求。

<!-- 忽略自动识别电话 -->
<meta name="format-detection" content="telephone=no" />

<!-- 忽略自动识别邮箱 -->
<meta name="format-detection" content="email=no" />

<!-- 忽略自动识别电话和邮箱 -->
<meta name="format-detection" content="telephone=no, email=no" />

弹出数字键盘

使用弹起数字键盘会带上#和*，适合输入电话。推荐使用弹起数字键盘，适合输入验证码等纯数字格式。

<!-- 纯数字带#和* -->
<input type="tel" />

<!-- 纯数字 -->
<input type="number" pattern="\d*" />

唤醒原生应用

通过 location.href 与原生应用建立通讯渠道，这种页面与客户端的通讯方式称为 URL Scheme，其基本格式为 scheme://[path][?query]。

scheme：应用标识，表示应用在系统里的唯一标识
path：应用行为，表示应用某个页面或功能
query：应用参数，表示应用页面或应用功能所需的条件参数

URL Scheme 一般由前端与客户端共同协商。唤醒原生应用的前提是必须在移动设备里安装了该应用，有些移动端浏览器即使安装了该应用也无法唤醒原生应用，因为它认为 URL Scheme 是一种潜在的危险行为而禁用它，像 Safari 和微信浏览器。还好微信浏览器可开启白名单让 URL Scheme 有效。

若在页面引用第三方原生应用的 URL Schema，可通过抓包第三方原生应用获取其 URL。

<!-- 打开微信 -->
<a href="weixin://">打开微信</a>

<!-- 打开支付宝 -->
<a href="alipays://">打开支付宝</a>

<!-- 打开支付宝的扫一扫 -->
<a href="alipays://platformapi/startapp?saId=10000007">打开支付宝的扫一扫</a>

<!-- 打开支付宝的蚂蚁森林 -->
<a href="alipays://platformapi/startapp?appId=60000002">打开支付宝的蚂蚁森林</a>

禁止页面缩放

在智能手机的普及下，很多网站都具备桌面端和移动端两种浏览版本，因此无需双击缩放查看页面。禁止页面缩放可保障移动端浏览器能无遗漏地展现页面所有布局。

<meta
  name="viewport"
  content="width=device-width, user-scalable=no, initial-scale=1, minimum-scale=1, maximum-scale=1"
/>

禁止页面缓存

Cache-Control 指定请求和响应遵循的缓存机制，不想使用浏览器缓存就禁止呗！

<meta http-equiv="Cache-Control" content="no-cache" />

禁止字母大写

有时在输入框里输入文本会默认开启首字母大写纠正，就是输入首字母小写会被自动纠正成大写，特么的烦。直接声明 autocapitalize=off 关闭首字母大写功能和 autocorrect=off 关闭纠正功能。

<input autocapitalize="off" autocorrect="off" />

针对 Safari 配置

<!-- 设置Safari全屏，在iOS7+无效 -->
<meta name="apple-mobile-web-app-capable" content="yes" />

<!-- 改变Safari状态栏样式，可选default/black/black-translucent，需在上述全屏模式下才有效 -->
<meta name="apple-mobile-web-app-status-bar-style" content="black" />

<!-- 添加页面启动占位图 -->
<link
  rel="apple-touch-startup-image"
  href="pig.jpg"
  media="(device-width: 375px)"
/>

<!-- 保存网站到桌面时添加图标 -->
<link rel="apple-touch-icon" sizes="76x76" href="pig.jpg" />

<!-- 保存网站到桌面时添加图标且清除默认光泽 -->
<link rel="apple-touch-icon-precomposed" href="pig.jpg" />

针对其他浏览器配置

<!-- 强制QQ浏览器竖屏 -->
<meta name="x5-orientation" content="portrait" />

<!-- 强制QQ浏览器全屏 -->
<meta name="x5-fullscreen" content="true" />

<!-- 开启QQ浏览器应用模式 -->
<meta name="x5-page-mode" content="app" />

<!-- 强制UC浏览器竖屏 -->
<meta name="screen-orientation" content="portrait" />

<!-- 强制UC浏览器全屏 -->
<meta name="full-screen" content="yes" />

<!-- 开启UC浏览器应用模式 -->
<meta name="browsermode" content="application" />

<!-- 开启360浏览器极速模式 -->
<meta name="renderer" content="webkit" />

让:active 有效，让:hover 无效

有些元素的:active 可能会无效，而元素的:hover 在点击后会一直处于点击状态，需点击其他位置才能解除点击状态。给<body>注册一个空的 touchstart 事件可将两种状态反转。

<body ontouchstart></body>

CSS 方向

自动适应布局

针对移动端，笔者通常会结合 JS 依据屏幕宽度与设计图宽度的比例动态声明<html>的 font-size，以 rem 为长度单位声明所有节点的几何属性，这样就能做到大部分移动设备的页面兼容，兼容出入较大的地方再通过媒体查询做特别处理。

笔者通常将 rem 布局比例设置成 1rem=100px，即在设计图上 100px 长度在 CSS 代码上使用 1rem 表示。

function AutoResponse(width = 750) {
  const target = document.documentElement;
  if (target.clientWidth >= 600) {
    target.style.fontSize = "80px";
  } else {
    target.style.fontSize = (target.clientWidth / width) * 100 + "px";
  }
}
AutoResponse();
window.addEventListener("resize", () => AutoResponse());

当然还可依据屏幕宽度与设计图宽度的比例使用 calc()动态声明 html 的 font-size，这样就能节省上述代码。不对，是完全代替上述代码。

html {
  font-size: calc(100vw / 7.5);
}

若以 iPad Pro 分辨率 1024px 为移动端和桌面端的断点，还可结合媒体查询做断点处理。1024px 以下使用 rem 布局，否则不使用 rem 布局。

@media screen and (max-width: 1024px) {
    html {
        font-size: calc(100vw / 7.5);
    }
}

自动适应背景

使用 rem 布局声明一个元素背景，多数情况会将 background-size 声明为 cover。可能在设计图对应分辨率的移动设备下，背景会完美贴合显示，但换到其他分辨率的移动设备下就会出现左右空出 1px 到 npx 的空隙。

此时将 background-size 声明为 100% 100%，跟随 width 和 height 的变化而变化。反正 width 和 height 都是量好的实际尺寸。

.elem {
  width: 1rem;
  height: 1rem;
  background: url("pig.jpg") no-repeat center/100% 100%;
}

监听屏幕旋转

/* 竖屏 */
@media all and (orientation: portrait) {
  /* 自定义样式 */
}
/* 横屏 */
@media all and (orientation: landscape) {
  /* 自定义样式 */
}

支持弹性滚动

在苹果系统上非 body 元素的滚动操作可能会存在卡顿，但安卓系统不会出现该情况。通过声明 overflow-scrolling:touch 调用系统原生滚动事件优化弹性滚动，增加页面滚动的流畅度。

body {
  -webkit-overflow-scrolling: touch;
}
.elem {
  overflow: auto;
}

禁止滚动传播

与桌面端浏览器不一样，移动端浏览器有一个奇怪行为。当页面包含多个滚动区域时，滚完一个区域后若还存在滚动动量则会将这些剩余动量传播到下一个滚动区域，造成该区域也滚动起来。这种行为称为滚动传播。

若不想产生这种奇怪行为可直接禁止。

overscroll-behavior: contain;

禁止屏幕抖动

对于一些突然出现滚动条的页面，可能会产生左右抖动的不良影响。在一个滚动容器里，打开弹窗就隐藏滚动条，关闭弹窗就显示滚动条，来回操作会让屏幕抖动起来。提前声明滚动容器的 padding-right 为滚动条宽度，就能有效消除这个不良影响。

每个移动端浏览器的滚动条宽度都有可能不一致，甚至不一定占位置，通过以下方式能间接计算出滚动条的宽度。100vw 为视窗宽度，100%为滚动容器内容宽度，相减就是滚动条宽度，妥妥的动态计算。

body {
  padding-right: calc(100vw - 100%);
}

禁止长按操作

有时不想用户长按元素呼出菜单进行点链接、打电话、发邮件、保存图片或扫描二维码等操作，声明 touch-callout:none 禁止用户长按操作。

有时不想用户复制粘贴盗文案，声明 user-select:none 禁止用户长按操作和选择复制。

* {
  /* pointer-events: none; */ /* 微信浏览器还需附加该属性才有效 */
  user-select: none; /* 禁止长按选择文字 */
  -webkit-touch-callout: none;
}

但声明 user-select:none 会让和无法输入文本，可对其声明 user-select:auto 排除在外。

input,
textarea {
  user-select: auto;
}

禁止字体调整

旋转屏幕可能会改变字体大小，声明 text-size-adjust:100%让字体大小保持不变。

* {
  text-size-adjust: 100%;
}

禁止高亮显示

触摸元素会出现半透明灰色遮罩，不想要！

* {
  -webkit-tap-highlight-color: transparent;
}

禁止动画闪屏

在移动设备上添加动画，多数情况会出现闪屏，给动画元素的父元素构造一个 3D 环境就能让动画稳定运行了。

.elem {
  perspective: 1000;
  backface-visibility: hidden;
  transform-style: preserve-3d;
}

美化表单外观

表单元素样式太丑希望自定义，appearance:none 来帮你。

button,
input,
select,
textarea {
  appearance: none;
  /* 自定义样式 */
}

美化滚动占位

滚动条样式太丑希望自定义，::-webkit-scrollbar-*来帮你。记住以下三个关键词就能随机应变了。

::-webkit-scrollbar：滚动条整体部分
::-webkit-scrollbar-track：滚动条轨道部分
::-webkit-scrollbar-thumb：滚动条滑块部分

::-webkit-scrollbar {
  width: 6px;
  height: 6px;
  background-color: transparent;
}
::-webkit-scrollbar-track {
  background-color: transparent;
}
::-webkit-scrollbar-thumb {
  border-radius: 3px;
  background-image: linear-gradient(135deg, #09f, #3c9);
}

美化输入占位

输入框占位文本太丑，::-webkit-input-placeholder 来帮你。

input::-webkit-input-placeholder {
  color: #66f;
}

对齐输入占位

有强迫症的同学总会觉得输入框文本位置整体偏上，感觉未居中心里就痒痒的。桌面端浏览器里声明 line-height 等于 height 就能解决，但移动端浏览器里还是未能解决，需将 line-height 声明为 normal 才行。

input {
  line-height: normal;
}

对齐下拉选项

下拉框选项默认向左对齐，是时候改改向右对齐了。

select option {
  direction: rtl;
}

修复点击无效

在苹果系统上有些情况下非可点击元素监听 click 事件可能会无效，针对该情况只需对不触发 click 事件的元素声明 cursor:pointer 就能解决。

.elem {
  cursor: pointer;
}

识别文本换行

多数情况会使用 JS 换行文本，那就真的 Out 了。若接口返回字段包含\n 或
，千万别替换掉，可声明 white-space:pre-line 交由浏览器做断行处理。

* {
  white-space: pre-line;
}

开启硬件加速

想动画更流畅吗，开启 GPU 硬件加速呗！

.elem {
  transform: translate3d(0, 0, 0);
  /* transform: translateZ(0); */
}

描绘像素边框

万年话题，如何描绘一像素边框？

.elem {
  position: relative;
  width: 200px;
  height: 80px;
  &::after {
    position: absolute;
    left: 0;
    top: 0;
    border: 1px solid #f66;
    width: 200%;
    height: 200%;
    content: "";
    transform: scale(0.5);
    transform-origin: left top;
  }
}

控制溢出文本

万年话题，如何控制文本做单行溢出和多行溢出？

.elem {
  width: 400px;
  line-height: 30px;
  font-size: 20px;
  &.sl-ellipsis {
    overflow: hidden;
    text-overflow: ellipsis;
    white-space: nowrap;
  }
  &.ml-ellipsis {
    display: -webkit-box;
    overflow: hidden;
    text-overflow: ellipsis;
    -webkit-line-clamp: 3;
    -webkit-box-orient: vertical;
  }
}

JS 方向

禁止点击穿透

移动端浏览器里点击操作会存在 300ms 延迟，往往会造成点击延迟甚至点击无效，这个是众所周知的事情。

2007 年苹果发布首款 iPhone 搭载的 Safari 为了将桌面端网站能较好地展示在移动端浏览器上而使用了双击缩放。该方案就是上述 300ms 延迟的主要原因，当用户执行第一次单击后会预留 300ms 检测用户是否继续执行单击，若是则执行缩放操作，若否则执行点击操作。鉴于该方案的成功，其他移动端浏览器也复制了该方案，现在几乎所有移动端浏览器都配备该功能。而该方案引发的点击延迟被称为点击穿透。

在前端领域里最早解决点击穿透是 jQuery 时代的 zepto，估计现在大部分同学都未使用过 zepto，其实它就是移动端版本的 jquery。zepto 封装 tap 事件能有效地解决点击穿透，通过监听 document 上的 touch 事件完成 tap 事件的模拟，并将 tap 事件冒泡到 document 上触发。

在移动端浏览器上不使用 click 事件而使用 touch 事件是因为 click 事件有着明显的延迟，后续又出现 fastclick。该解决方案监听用户是否做了双击操作，可正常使用 click 事件，而点击穿透就交给 fastclick 自动判断。更多 fastclick 原理可自行百度，在此不作过多介绍。

fastclick 有现成的 NPM 包，可直接安装到项目里。引入 fastclick 可使用 click 事件代替 tap 事件，接入方式极其简单。

import Fastclick from "fastclick";

FastClick.attach(document.body);

禁止滑动穿透

移动端浏览器里出现弹窗时，若在屏幕上滑动能触发弹窗底下的内容跟着滚动，这个是众所周知的事情。

首先明确解决滑动穿透需保持哪些交互行为，那就是除了弹窗内容能点击或滚动，其他内容都不能点击或滚动。目前很多解决方案都无法做到这一点，全部解决方案都能禁止<body>的滚动行为却引发其他问题。

弹窗打开后内部内容无法滚动
弹窗关闭后页面滚动位置丢失
Webview 能上下滑动露出底色

当打开弹窗时给 body 声明 position:fixed;left:0;width:100%并动态声明 top。声明 position:fixed 会导致 body 滚动条消失，此时会发现虽然无滑动穿透，但页面滚动位置早已丢失。通过 scrollingElement 获取页面当前滚动条偏移量并将其取负值且赋值给 top，那么在视觉上就无任何变化。当关闭弹窗时移除 position:fixed;left:0;width:100%和动态 top。

scrollingElement 可兼容地获取 scrollTop 和 scrollHeight 等属性，在移动端浏览器里屡试不爽。document.scrollingElement.scrollHeight 可完美代替曾经的 document.documentElement.scrollHeight

document.body.scrollHeight，一眼看上去就是代码减少了。

该解决方案在视觉上无任何变化，完爆其他解决方案，其实就是一种反向思维和障眼法。该解决方案完美解决固定弹窗和滚动弹窗对 body 全局滚动的影响，当然也可用于局部滚动容器里，因此很值得推广。

body.static {
  position: fixed;
  left: 0;
  width: 100%;
}

const body = document.body;
const openBtn = document.getElementById("open-btn");
const closeBtn = document.getElementById("close-btn");
openBtn.addEventListener("click", (e) => {
  e.stopPropagation();
  const scrollTop = document.scrollingElement.scrollTop;
  body.classList.add("static");
  body.style.top = `-${scrollTop}px`;
});
closeBtn.addEventListener("click", (e) => {
  e.stopPropagation();
  body.classList.remove("static");
  body.style.top = "";
});

支持往返刷新

点击移动端浏览器的前进按钮或后退按钮，有时不会自动执行旧页面的 JS 代码，这与往返缓存有关。这种情况在 Safari 上特别明显，简单概括就是往返页面无法刷新。

往返缓存指浏览器为了在页面间执行前进后退操作时能拥有更流畅体验的一种策略，以下简称 BFCache。该策略具体表现为：当用户前往新页面前将旧页面的 DOM 状态保存在 BFCache 里，当用户返回旧页面前将旧页面的 DOM 状态从 BFCache 里取出并加载。大部分移动端浏览器都会部署 BFCache，可大大节省接口请求的时间和带宽。

了解什么是 BFCache 再对症下药，解决方案就在 window.onunload 上做文章。

// 在新页面监听页面销毁事件
window.addEventListener("onunload", () => {
  // 执行旧页面代码
});

若在 Vue SPA 上使用 keep-alive 也不能让页面刷新，可将接口请求放到 beforeRouteEnter()里。

当然还有另一种解决方案。pageshow 事件在每次页面加载时都会触发，无论是首次加载还是再次加载都会触发，这就是它与 load 事件的区别。pageshow 事件暴露的 persisted 可判断页面是否从 BFCache 里取出。

window.addEventListener("pageshow", (e) => e.persisted && location.reload());

若浏览器不使用<meta http-equiv=”Cache-Control” content=”no-cache”>禁用缓存，该解决方案还是很值得一用。

解析有效日期

在苹果系统上解析 YYYY-MM-DD HH:mm:ss 这种日期格式会报错 Invalid Date，但在安卓系统上解析这种日期格式完全无问题。

查看 Safari 相关开发手册发现可用 YYYY/MM/DD HH:mm:ss 这种日期格式，简单概括就是年月日必须使用/衔接而不能使用-衔接。当然安卓系统也支持该格式，然而接口返回字段的日期格式通常是 YYYY-MM-DD HH:mm:ss，那么需替换其中的-为/。

const date = "2019-03-31 21:30:00";
new Date(date.replace(/\-/g, "/"));

修复高度坍塌

当页面同时出现以下三个条件时，键盘占位会把页面高度压缩一部分。当输入完成键盘占位消失后，页面高度有可能回不到原来高度，产生坍塌导致 Webview 底色露脸，简单概括就是输入框失焦后页面未回弹。

页面高度过小
输入框在页面底部或视窗中下方
输入框聚焦输入文本

只要保持前后滚动条偏移量一致就不会出现上述问题。在输入框聚焦时获取页面当前滚动条偏移量，在输入框失焦时赋值页面之前获取的滚动条偏移量，这样就能间接还原页面滚动条偏移量解决页面高度坍塌。

const input = document.getElementById("input");
let scrollTop = 0;
input.addEventListener("focus", () => {
  scrollTop = document.scrollingElement.scrollTop;
});
input.addEventListener("blur", () => {
  document.scrollingElement.scrollTo(0, scrollTop);
});

修复输入监听

在苹果系统上的输入框输入文本，keyup/keydown/keypress 事件可能会无效。当输入框监听 keyup 事件时，逐个输入英文和数字会有效，但逐个输入中文不会有效，需按回车键才会有效。

此时可用 input 事件代替输入框的 keyup/keydown/keypress 事件。

简化回到顶部

曾几何时编写一个返回顶部函数麻烦得要死，需 scrollTop、定时器和条件判断三者配合才能完成。其实 DOM 对象里隐藏了一个很好用的函数可完成上述功能，一行核心代码就能搞定。

该函数就是 scrollIntoView，它会滚动目标元素的父容器使之对用户可见，简单概括就是相对视窗让容器滚动到目标元素位置。它有三个可选参数能让 scrollIntoView 滚动起来更优雅。

behavior：动画过渡效果，默认 auto 无，可选 smooth 平滑
inline：水平方向对齐方式，默认 nearest 就近对齐，可选 start 顶部对齐、center 中间对齐和 end 底部对齐
block：垂直方向对齐方式，默认 start 顶部对齐，可选 center 中间对齐、end 底部对齐和 nearest 就近对齐

const gotopBtn = document.getElementById("gotop-btn");
openBtn.addEventListener("click", () =>
  document.body.scrollIntoView({ behavior: "smooth" })
);

当然还可滚动到目标元素位置，只需将 document.body 修改成目标元素的 DOM 对象。一行核心代码就能搞掂的事情为何还编写那么多代码去完成，不累吗？

简化懒性加载

与上述简化回到顶部一样，编写一个懒性加载函数也同样需 scrollTop、定时器和条件判断三者配合才能完成。其实 DOM 对象里隐藏了一个很好用的函数可完成上述功能，该函数无需监听容器的 scroll 事件，通过浏览器自身机制完成滚动监听。

该函数就是 IntersectionObserver，它提供一种异步观察目标元素及其祖先元素或顶级文档视窗交叉状态的方法。详情可参照 MDN 文档，在此不作过多介绍。

懒性加载的第一种使用场景：图片懒加载。只需确认图片进入可视区域就赋值加载图片，赋值完成还需对图片停止监听。

<img data-src="pig.jpg">
<!-- 很多<img> -->

const imgs = document.querySelectorAll("img.lazyload");
const observer = new IntersectionObserver(nodes => {
    nodes.forEach(v => {
        if (v.isIntersecting) { // 判断是否进入可视区域
            v.target.src = v.target.dataset.src; // 赋值加载图片
            observer.unobserve(v.target); // 停止监听已加载的图片
        }
    });
});
imgs.forEach(v => observer.observe(v));

懒性加载的第二种使用场景：下拉加载。在列表最底部部署一个占位元素且该元素无任何高度或实体外观，只需确认占位元素进入可视区域就请求接口加载数据。

<ul>
    <li></li>
    <!-- 很多<li> -->
</ul>
<!-- 也可将#bottom以<li>的形式插入到<ul>内部的最后位置 -->
<div id="bottom"></div>

const bottom = document.getElementById("bottom");
const observer = new IntersectionObserver(nodes => {
    const tgt = nodes[0]; // 反正只有一个
    if (tgt.isIntersecting) {
        console.log("已到底部，请求接口");
        // 执行接口请求代码
    }
})
observer.observe(bottom);

优化扫码识别

通常移动端浏览器都会配备长按二维码图片识别链接的功能，但长按二维码可能无法识别或错误识别。二维码表面看上去是一张图片，可二维码生成方式却五花八门，二维码生成方式有以下三种。

使用<img>渲染
使用<svg>渲染
使用<canvas>渲染

从网易 MTL 的测试数据得知，大部分移动端浏览器只能识别 img 渲染的二维码，为了让全部移动端浏览器都能识别二维码，那只能使用 img 渲染二维码了。若使用 SVG 和 Canvas 的方式生成二维码，那就想方设法把二维码数据转换成 Base64 再赋值到 img 的 src 上。

一个页面可能存在多个二维码，若长按二维码只能识别最后一个，那只能控制每个页面只存在一个二维码。

自动播放媒体

常见媒体元素包括音频 audio 和视频 video，为了让用户得到更好的媒体播放体验与不盲目浪费用户流量，大部分移动端浏览器都明确规定不能自动播放媒体或默认屏蔽 autoplay。为了能让媒体在页面加载完成后自动播放，只能显式声明播放。

const audio = document.getElementById("audio");
const video = document.getElementById("video");
audio.play();
video.play();

对于像微信浏览器这样的内置浏览器，还需监听其应用 SDK 加载完成才能触发上述代码，以保障 WebView 正常渲染。其他内置浏览器同理，在此不作过多介绍。

document.addEventListener("WeixinJSBridgeReady", () => {
  // 执行上述媒体自动播放代码
});

在苹果系统上明确规定用户交互操作开始后才能播放媒体，未得到用户响应会被 Safari 自动拦截，因此需监听用户首次触摸操作并触发媒体自动播放，而该监听仅此一次。

document.body.addEventListener(
  "touchstart",
  () => {
    // 执行上述媒体自动播放代码
  },
  { once: true }
);