Amaze UI

JS 插件

Amaze UI JS 插件,使用注意事项,以及 JS 插件介绍。

FastClick


v2.4 重要变更:

由于引入 FastClick 以后会产生一些问题,从 v2.4 开始移除,需要的用户请直接从 FastClick 官方项目获取。

处理移动端 click 事件 300 毫秒延迟, 由 FT Labs 开发(项目地址)。

为什么存在延迟?

根据 Google 开发者文档

...mobile browsers will wait approximately 300ms from the time that you tap the button to fire the click event. The reason for this is that the browser is waiting to see if you are actually performing a double tap.

从点击屏幕上的元素到触发元素的 click 事件,移动浏览器会有大约 300 毫秒的等待时间。为什么这么设计呢? 因为它想看看你是不是要进行双击(double tap)操作。

兼容性

  • Mobile Safari on iOS 3 and upwards
  • Chrome on iOS 5 and upwards
  • Chrome on Android (ICS)
  • Opera Mobile 11.5 and upwards
  • Android Browser since Android 2
  • PlayBook OS 1 and upwards

不应用 FastClick 的场景

  • 桌面浏览器;
  • 如果 viewport meta 标签 中设置了 width=device-width, Android 上的 Chrome 32+ 会禁用 300ms 延时;
<meta name="viewport" content="width=device-width, initial-scale=1">
  • viewport meta 标签如果设置了 user-scalable=no,Android 上的 Chrome(所有版本)都会禁用 300ms 延迟。
  • IE10 中,可以使用 css 属性 -ms-touch-action: none 禁止元素双击缩放(参考文章)。

使用方法

Amaze UI 默认已经初始化 FastClick。

如有需要,用户可以通过 $.AMUI.FastClick 调用。

jQuery / Zepto.js:

$(function() {
  $.AMUI.FastClick.attach(document.body);
});

CommonJS:

var attachFastClick = require('fastclick');
attachFastClick(document.body);

常见问题

使用 FastClick 以后 contenteditable 在触摸屏上失效,如何处理?

在需要启动编辑功能的元素上添加 .needsclick class 即可(在线演示)。

请使用触屏访问,然后尝试编辑下面的内容

编我改我写我……


没有加 needsclick class,触摸屏加载 FastClick 以后注定无法编辑。
<div contenteditable class="needsclick">
  <p>请使用触屏访问,然后尝试编辑下面的内容</p>
  <p>编我改我写我……</p>
</div>
<hr>
<div contenteditable>
  没有加 <code>needsclick</code> class,触摸屏加载 FastClick 以后注定无法编辑。
</div>

Licence

  • @copyright The Financial Times Limited [All Rights Reserved]
  • @license MIT License
侧栏导航
Amaze UI 微信
在微信上关注我们