iScroll5中文API.pdf

1.版本 前言 最近项目上需要使用iScroll，在中文圈里找了找，只找到了iScroll 4的中文版 API。加上最近开始使用github （准确说，github账号是很多年前注册的，一直 在企业应用里摸爬滚打，荒废了账号很长时间，是理由吗？是理由吗？），出于 对开源社区的敬意，我突然觉得应该做点啥，于是先挑一个简单点儿的，把iScroll 5的API翻译一下，方便中文用户使用。 搭后语 iScroll对于我来讲典型的应用场景位于移动设备的App，基于 Cordova/Phonegap + JQM + iScroll开发移动设备上的App，对于以数据呈 现为主体的企业应用来讲无疑是一个多快好省的解决方案。这三驾马车前两个可 开发框架 iScroll iScroll 以堂而皇之的称之为 ， 只能称之为工具，尽管如此， 带来 的强大的滚动功能，能节省我们在项目开发上的部分时间（这也是开源社区的力 量），所以也值得我花时间理解作者的代码和文档。如果您认同这种功劳苦劳， 请到github上给我一个star。由于才疏学浅，在翻译过程中难免会有错误或者 瑕疵，请在issure中提出，我会及时更正。 下面，我们开始iScroll之旅，请系好安全带。 iScroll简介 iScroll是一个高性能，资源占用少，无依赖，多平台的javascript 滚动插件。 它可以在桌面，移动设备和智能电视平台上工作。它一直在大力优化性能和文件 大小以便在新旧设备上提供最顺畅的体验。 iScroll不仅仅是 滚动。它可以处理任何需要与用户进行移动交互的元素。在你 的项目中包含仅仅4kb大小的iScroll，你的项目便拥有了滚动，缩放，平移， 无限滚动，视差滚动，旋转功能。给它一个扫帚它甚至能帮你打扫办公室。 即使平台本身提供的滚动已经很不错，iScroll可以在此基础上提供更多不可思议 的功能。具体来说：  细粒度控制滚动位置，甚至在滚动过程中。你总是可以获取和设置滚动器 的x，y坐标。  动画可以使用用户自定义的擦出功能（反弹bounce，弹性elastic，回 退back，...）。  你可以很容易的挂靠大量的自定义事件（onBeforeScrollStart, *  iPhone Chro e 开箱即用的多平台支持。从很老的安卓设备到必威体育精装版的 ，从 浏览器到IE浏览器。 2.入门 你想成为iScroll大师。行，这就是我写以下内容的目的。 最好的学习iScroll的方法是看示例。在存档文件中你会发现一个叫做demo 的文 件夹示例。这里有大多数脚本功能的概述。 IScroll是一个类，每个需要使用滚动功能的区域均要进行初始化。每个页面上 的iScroll实例数目在设备的CPU和内存能承受的范围内是没有限制的。 尽可能保持DOM结构的简洁。iScroll使用硬件合成层但是有一个限制硬件可以 处理的元素。 最佳的HTML结构如下： div id=wrapper ul li.../li li.../li ... /ul/div iScroll UL 作用于滚动区域的外层。在上面的例子中， 元素能进行滚动。只有容 器元素的第一个子元素能进行滚动，其他子元素完全被忽略。 box-shadow,opacity,text-shadow and alpha channels are all properties that dont go very well together with hardware acceleration. Scrolling might look good with few elements but as soon as your DOM becomes more complex youll start experiencing lag and jerkiness. Sometimes a background ima