FastClick 源码解读

wxuande 2019-06-20

其实一直就想花些时间读一读那些优秀的开源库，今天终于下了决定打算死磕下自己，2016年每个月读2-3个优秀的开源库，把源码精彩的地方和自己心得分享给大家。

目录

（一）背景
（二）源码解析
（三）Zepto 点击穿透与 FastClick
（四）新技能 Get
（五）参考文献

（一）背景

做前端的一定都知道，原生click事件在移动浏览器上会有300毫秒的延迟，会让用户觉得卡顿，这300毫秒到底是怎么来的呢，估计就不太知道了，再继续深究这300毫秒的来源是什么，应该会更少人知道吧。国外有一篇很有名的文章说的很详细，有兴趣可以看一下：what-exactly-is.....-the-300ms-click-delay。简短来说：是移动浏览器都支持双击缩放或双击滚动的操作，由于当用户第一次点击屏幕后，浏览器不能立刻判断用户确实要打开这个链接，还是想要进行双击的操作，因此几乎现在所有浏览器都效仿Safari当年的约定，在点击事件上加了300毫秒的延迟。

在这个web页面横行的年代，每个点击事件都有300毫秒的延迟是不允许的。再后来出来了很多的解决办法，比如Zepto的tap事件（会引发击穿的bug，后面会着重说），fastclick.js等都可以解决，但是多多少少会有些负作用，综合起来我最喜欢fastclick的解决方案，今天就来读一读它的源码吧~

（二）解析

1. 引入 FastClick 到自己的环境

829行：现在一般插件都会用这种方式兼容AMD、commonJs风格、原生Js的方式。还有CMD等这里没有兼容，这里可以根据自己项目需求稍作修改。

//优先兼容AMD方式
if (typeof define === 'function' && typeof define.amd === 'object' && define.amd) {
  define(function() {
    return FastClick;
  });
} else if (typeof module !== 'undefined' && module.exports) {
  //兼容commonJs风格
  module.exports = FastClick.attach;
  module.exports.FastClick = FastClick;
} else {
  //最后兼容原生Js  
  window.FastClick = FastClick;
}

2. 入口

824行：FastClick入口方法attach

//layer参数：要监听的dom对象，一般是document.body
//options参数：用来覆盖自定义参数，个人建议不去覆盖，
//因为里面的参数设定都是FastClick的精华，
//比如规定了touchstart和touchend事件之间的200毫秒最小间隔。
FastClick.attach = function(layer, options) {
  return new FastClick(layer, options);
};

3. FastClick 函数

1. 23-103行：设置默认值

//比如这几个参数，上面提到不建议自定义覆盖，
//这些参数正是FastClick的精华所在，
//大幅度修改数值可能让整个库的功效大打折扣。
this.touchBoundary = options.touchBoundary || 10;
this.tapDelay = options.tapDelay || 200;
this.tapTimeout = options.tapTimeout || 700;

2. 105-107行：判断是否需要调用FastClick

官网上when-it-isnt-needed说的很清楚，以下情况不需要FastClick。

  1. 所有pc浏览器

  2. 浏览器不支持ontouchstart

  3. 安卓中chrome(all versions)meta中有user-scalable="no"属性

  4. 安卓中chrome 32+ meta中有width=device-width 属性

  5. BlackBerry 10.3+

  6. Firefox 27+

  7. 有-ms-touch-action: manipulation属性的IE10

  8. 有touch-action: manipulation属性的IE11

//所以在不需要FastClick的浏览器会直接return掉，
//不会执行下面的所有代码。
if (FastClick.notNeeded(layer)) {
  return;
}

3. 110-132行：自定义函数绑定在对应默认事件上

layer.addEventListener('touchstart', this.onTouchStart, false);
layer.addEventListener('touchmove', this.onTouchMove, false);
layer.addEventListener('touchend', this.onTouchEnd, false);
layer.addEventListener('touchcancel', this.onTouchCancel, false);

4. 137-159行：对旧版本android不支持 stopImmediatePropagation 事件的兼容

这里有一个知识点：stopImmediatePropagation和stopPropagation的区别，后面总结会详细说。

5. 164-173行：兼容直接绑定在dom上的onclick事件

//把<body onclick="fun()"></body> 直接绑定在dom上的onclick事件
//改为绑定在该dom上的形式，
//为了之后的模拟点击事件。
if (typeof layer.onclick === 'function') {
  oldOnClick = layer.onclick;
  layer.addEventListener('click', function(event) {
    oldOnClick(event);
  }, false);
  layer.onclick = null;
}

4. 兼容 & 判断

181-219行：浏览器UA判断
311-319行：determineEventType 兼容安卓chrome中的select框事件从click改为mousedown
325-355行：focus 兼容苹果手机setSelectionRange不能正确获取焦点的bug
343-367行：updateScrollParent （待看）
374-382行：getTargetElementFromEventTarget 兼容获取点击元素，iOS 4.1中会获取文字作为焦点，取它的父元素dom
497-512行：findControl

//点击label的时候，找到他对应的元素，并获取焦点
<label for="input"></label>
<input id="input"/>

459-467：touchHasMoved 手指点击时移动间距大于10px，返回true
476-488：onTouchMove 手指点击时移动间距大于10px，即视为touchmove，不触发模拟click事件

5. 进阶方法

一般情况下用不到，以下方法，特殊需求可能会用到。

227-254行：needsClick 确定哪些元素需要原生的click事件
263-285行：needsFocus 确定哪些元素需要原生的focus事件

//如果哪些元素需要使用原生的click或者是focus事件，需要在dom上加上class='needsClick'
<a class="needsclick">Ignored by FastClick</a>

712-726行：destroy 这个方法只在源码中，如果有需求销毁事件，重构源码时可以调用这个方法。

6. 核心方法

391-450：onTouchStart

FastClick.prototype.onTouchStart = function(event) {
  //tapDelay默认300毫秒，点击时间差小于300毫秒，则阻止事件再次触发，阻止短时间内双击的问题
  if ((event.timeStamp - this.lastClickTime) < this.tapDelay) {
    event.preventDefault();
  }
}

521-610：onTouchEnd

if (!this.needsClick(targetElement)) {
  // 如果这不是一个需要使用原生click的元素，则屏蔽原生事件，避免触发两次click
  event.preventDefault(); 
  // 触发一次模拟的click
  this.sendClick(targetElement, event);
}

294-309：sendClick（核心方法）

//这个事件会在onTouchEnd中用到，经过一系列的判断，符合条件，调用这个模拟事件
FastClick.prototype.sendClick = function(targetElement, event) {
  var clickEvent, touch;
  //创建一个鼠标事件
  clickEvent = document.createEvent('MouseEvents');
  //初始化鼠标事件
  clickEvent.initMouseEvent(this.determineEventType(targetElement), true, true, window, 1, touch.screenX, touch.screenY, touch.clientX, touch.clientY, false, false, false, false, 0, null);
  //触发这个事件
  targetElement.dispatchEvent(clickEvent);
};

（三）Zepto 点击穿透与 FastClick

最近项目中在用Zepto的插件touch.js中tap事件，来解决移动浏览器中300毫秒延迟的问题。但是出现了各种击穿现象

  1. 同页面tap点击弹出弹层，弹层中也有一个button，正好重叠的时候，会出现击穿

  2. tap事件点击，页面跳转，新页面中同位置也有一个按钮，会出现击穿

我们可以看下Zepto对 singleTap 事件的处理。见源码 136-143 行，可以看出在 touchend 响应 250ms 无操作后，则触发singleTap。

//trigger single tap after 250ms of inactivity
else {
  touchTimeout = setTimeout(function(){
    touchTimeout = null
    if (touch.el) touch.el.trigger('singleTap')
    touch = {}
  }, 250)
}

用这篇文章里面的一句话来解释下Zepto的穿透问题也来说说touch事件与点击穿透问题

  1. zepto中的 tap 通过兼听绑定在 document 上的 touch 事件来完成 tap 事件的模拟的，是通过事件冒泡实现的。在点击完成时（touchstart / touchend）的 tap 事件需要冒泡到 document 上才会触发。而在冒泡到 document 之前，手指接触和离开屏幕（touchstart / touchend）是会触发 click 事件的。

  2. 因为 click 事件有延迟（大概是300ms，为了实现safari的双击事件的设计），所以在执行完 tap 事件之后，弹出层立马就隐藏了，此时 click 事件还在延迟的 300ms 之中。当 300ms 到来的时候，click 到的其实是隐藏元素下方的元素。

  3. 如果正下方的元素有绑定 click 事件，此时便会触发，如果没有绑定 click 事件的话就当没发生。如果正下方的是 input 输入框（或是 select / radio / checkbox），点击默认 focus 而弹出输入键盘，也就出现了上面的“点透”现象。

所以到这里，个人还是建议直接使用fastclick.js库来解决移动端浏览器300毫秒的问题，不建议自己写，坑还是挺多的，这个库压缩后还是挺小的，可以用各种方式引用，来替代Zepto中的touch.js插件是个不错的办法。

（四）新技能 Get

通过读这个库，发现了很多知识上的盲区或者理解的并不是很透彻的点，再深化一下~

  1. stopImmediatePropagation 和 stopPropagation 的区别 参考文章

    1. 他们都可以阻止事件冒泡到父元素

    2. stopImmediatePropagation多做了一件事：阻止绑定在该元素上其他事件运行

（五）参考文献

  1. 300毫秒的起源：what-exactly-is.....-the-300ms-click-delay

wxuande

wxuande

相关推荐

app开发中，苹果端可编辑标签，无法输入内容解决方案

　　在app开发，在使用div的contentedstable属性时，出现ios端编辑框无法选择聚焦的问题，查阅资料后发现是fastclick.js中的判断导致的。　　a.引入“.needsclick{content: attr;}”，类名，“needsc

Bloddy / 0评论 2019-10-28

关于前端开发

--移动端基本常用配置-->. content="width=device-width, initial-scale=1.0, maximum-scale=1.0, minimum-scale=1.0, user-scalable=no&q

hcl / 0评论 2017-10-12

fastclick 导致Ant Design框架的Upload组件在ios设备上点击异常

问题描述引入Ant Design的上传组件，在PC端和Android端点击上传正常，而在IOS端单击没反应，双击能弹出上传组件窗口。产生原因直接原因是项目中引入了fastclick，而fastclick有点小bug，导致IOS端点击出现异常。具体原因请看c

好好学习天天 / 0评论 2019-06-28

浅谈FastClick 填坑及源码解析

最近产品妹子提出了一个体验issue ―― 用 iOS 在手Q阅读书友交流区发表书评时，光标点击总是不好定位到正确的位置：。一开始我以为是 iOS 原生的交互问题没太在意，但后来发现访问某些页面又是没有这种奇怪体验的。于是只好继续做排除法，把页面上的一些库

狂野之士 / 0评论 2018-03-02

通过fastclick源码分析彻底解决tap“点透”

近期使用tap事件为老夫带来了这样那样的问题，其中一个问题是解决了点透还需要将原来一个个click变为tap，这样的话我们就抛弃了ie用户。当然可以做兼容，但是没人想动老代码的，于是今天拿出了fastclick这个东西，这是最近第四次发文说tap的点透事件

sean0 / 0评论 2017-12-24

vue 添加vux的代码讲解

Vux是基于WeUI和Vue(2.x)开发的移动端UI组件库，主要服务于微信页面。基于webpack+vue-loader+vux可以快速开发移动端页面，配合vux-loader方便你在WeUI的基础上定制需要的样式。vux-loader保证了组件按需使用

Haines / 0评论 2017-11-30

移动端300ms延迟由来及解决方案

300 毫秒延迟的主要原因是解决双击缩放。双击缩放，顾名思义，即用手指在屏幕上快速点击两次，iOS 自带的 Safari 浏览器会将网页缩放至原始比例。因此，iOS Safari 就等待 300 毫秒，以判断用户是否再次点击了屏幕。鉴于iPhone的成功，

华兴观点 / 0评论 2018-04-02