iiunknown / iscroll5.doc.cn

iScroll 5 API 中文版

iScroll 5 API 中文版

Gitbook发布版本

前言

最近项目上需要使用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，从Chrome浏览器到IE浏览器。

iscroll5.doc.cn's Issues

۰د

“基本功能”页错别字

options.preventDefault

当事件触发时**“师傅”执行preventDefault()。
应该是“是否”**吧 😂

从头到尾都没有原版的任何信息

您就大方一点，给出原版的API地址或者iScroll的github地址吧。
我在github上搜索，有好多iScroll的名字，不确定你这个说得到底是那个，虽然按照star的数量还是可以隐约猜出是哪一个，但是你这个翻译版怎么也要给出点信息才对吧。

iscroll

怎么引入iscroll-lite.js？？？

快速滚动卡住现象

我用的是iscroll-probe.js，当我快熟滑动屏幕时，我注册的scroll（myScroll.on('scroll', updatePosition)）会无限执行，导致我的页面卡住没有响应了。通过我跟踪代码最终定位到_animate方法，但我也解决不了问题。

“肩痛”应为“监听”

page:basicfeatures.html

options.disableMouse
options.disablePointer
options.disableTouch

默认情况下，iScroll肩痛所有的指针事件，

如上！

iscroll5js 有40多K呀，怎么是4K左右呢

4

给个建议

既然都翻译好了，建议弄一个线上的链接，能帮助更多又需要的人。

标题名是个链接格式的，习惯性会复制iscroll5.doc.cn 查看有没有线上的文档，结果打开是个广告，这个不太友好。

文档的链接应该是这个吧，建议在进来第一个Readme加个链接。
http://iiunknown.gitbooks.io/iscroll-5-api-cn/content/