[4/4] incubator-weex git commit: * [doc] merge scroller&dom&slider file update

[tancy]

* [doc] merge scroller&dom&slider file update


Project: http://git-wip-us.apache.org/repos/asf/incubator-weex/repo
Commit: http://git-wip-us.apache.org/repos/asf/incubator-weex/commit/5675ef71
Tree: http://git-wip-us.apache.org/repos/asf/incubator-weex/tree/5675ef71
Diff: http://git-wip-us.apache.org/repos/asf/incubator-weex/diff/5675ef71

Branch: refs/heads/dev
Commit: 5675ef71f23ba5a15ec1b852f002db860b765220
Parents: 855f69b c4fa292
Author: tancy <ron...@gmail.com>
Authored: Wed May 17 16:52:23 2017 +0800
Committer: tancy <ron...@gmail.com>
Committed: Wed May 17 16:52:23 2017 +0800

----------------------------------------------------------------------
 doc/source/cn/references/components/list.md     | 13 +++++++++++++
 doc/source/cn/references/components/scroller.md | 15 +++++++++++++--
 doc/source/cn/references/components/slider.md   | 11 +++++------
 doc/source/cn/references/modules/dom.md         |  5 +++--
 4 files changed, 34 insertions(+), 10 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/incubator-weex/blob/5675ef71/doc/source/cn/references/components/list.md
----------------------------------------------------------------------
diff --cc doc/source/cn/references/components/list.md
index e6cd20a,3cc3049..7c8b2b2
--- a/doc/source/cn/references/components/list.md
+++ b/doc/source/cn/references/components/list.md
@@@ -42,10 -42,8 +42,11 @@@ version: 2.
  ## 特性
  
  - `loadmoreoffset {number}`：默认值为 0，触发 `loadmore` 
事件所需要的垂直偏移距离（设备屏幕底部与 `<list>` 
底部之间的距离）。当 `<list>` 的滚动条滚动到足够接近 
`<list>` 底部时将会触发 `loadmore` 这个事件。
+ - `offset-accuracy {number}` <sup 
class="wx-v">0.11+</sup>：控制`onscroll`事件触发的频率，默认值为10，表示两次`onscroll`事件之间列表至少滚动了10px。注意，将该值设置为较小的数值会提高滚动事件采æ
 ·çš„精度，但同时也会降低页面的性能。
  
 +  ![mobile_preview](../images/list_4.jpg)
 +
 +- `offset-accuracy`：默认值是0，触发 `scroll` 
事件所需要的垂直偏移距离。
  ## 样式
  
  - 通用样式：支持所有通用样式
@@@ -61,13 -59,16 +62,22 @@@
  ## 事件
  
  - `loadmore` <sup 
class="wx-v">0.5+</sup>：如果列表滚动到底部将会立即触发这个事件，ä½
 å¯ä»¥åœ¨è¿™ä¸ªäº‹ä»¶çš„处理函数中加载下一页的列表项。
+ - `onscroll` <sup class="wx-v">0.11+</sup>: 
列表发生滚动时将会触发该事件，事件的默认抽æ 
·çŽ‡ä¸º10px，即列表每滚动10px触发一次，可通过属性`offset-accuracy`设置抽æ
 ·çŽ‡ã€‚    
+   
+   事件中 event 对象属性：
+   - `contentSize {Object}`：列表的内容尺寸
+     - `width {number}`: 列表内容宽度
+     - `height {number}`: 列表内容高度
+   - `contentOffset {Object}`: 列表的偏移尺寸
+     - `x {number}`: x轴上的偏移量
+     - `y {number}`: y轴上的偏移量
  
 +  [体验一下](http://dotwe.org/bc445ede8746a31360e3607d210304c5)
 +
 +- `scroll` <sup 
class="wx-v">0.12+</sup>：列表滚动时触发这个事件。此事件回调中会给出当前`contentOffset`值。
 +
 +  [体验一下](http://dotwe.org/weex/5837c1b7f1f69e5adf1fc4cac0747c34)
 +
  - 通用事件
  
    支持所有通用事件：

http://git-wip-us.apache.org/repos/asf/incubator-weex/blob/5675ef71/doc/source/cn/references/components/scroller.md
----------------------------------------------------------------------
diff --cc doc/source/cn/references/components/scroller.md
index 4a9c374,175b3f7..dd74525
--- a/doc/source/cn/references/components/scroller.md
+++ b/doc/source/cn/references/components/scroller.md
@@@ -42,10 -41,9 +42,11 @@@ version: 2.
  
    ![mobile_preview](../images/scroller_1.jpg)
  
- - `loadmoreretry {number}`：默认值为 0，当 `loadmore` 
失败时是否重置 `loadmore` 相关的 UI，值不一样就会重置。
+ - ~~`loadmoreretry {number}`：默认值为 0，当 `loadmore` 
失败时是否重置 `loadmore` 相关的 UI，值不一样就会重置。~~ 
该属性已废弃，请使用`resetLoadmore()`函数实现重置`loadmore`的操作。
+ - `offset-accuracy {number}` <sup 
class="wx-v">0.11+</sup>：控制`onscroll`事件触发的频率，默认值为10，表示两次`onscroll`事件之间列表至少滚动了10px。注意，将该值设置为较小的数值会提高滚动事件采æ
 ·çš„精度，但同时也会降低页面的性能。
  
 +- `offset-accuracy`：默认值是0，触发 `scroll` 
事件所需要的垂直偏移距离。
 +
  ## 样式
  
  - 通用样式：支持所有通用样式
@@@ -61,8 -59,15 +62,15 @@@
  ## 事件
  
  - `loadmore` <sup 
class="wx-v">v0.5+</sup>：如果滚动到底部将会立即触发这个事件，ä½
 å¯ä»¥åœ¨è¿™ä¸ªäº‹ä»¶çš„处理函数中加载下一页的列表项。
 -- `onscroll` <sup class="wx-v">0.11+</sup>: 
列表发生滚动时将会触发该事件，事件的默认抽æ 
·çŽ‡ä¸º10px，即列表每滚动10px触发一次，可通过属性`offset-accuracy`设置抽æ
 ·çŽ‡ã€‚    
++- `scroll` <sup class="wx-v">0.11+</sup>: 
列表发生滚动时将会触发该事件，事件的默认抽æ 
·çŽ‡ä¸º10px，即列表每滚动10px触发一次，可通过属性`offset-accuracy`设置抽æ
 ·çŽ‡ã€‚    
  
- - `scroll` <sup 
class="wx-v">0.12+</sup>：列表滚动时触发这个事件。此事件回调中会给出当前`contentOffset`值。
+   事件中 event 对象属性：
+   - `contentSize {Object}`：列表的内容尺寸
+     - `width {number}`: 列表内容宽度
+     - `height {number}`: 列表内容高度
+   - `contentOffset {Object}`: 列表的偏移尺寸
+     - `x {number}`: x轴上的偏移量
+     - `y {number}`: y轴上的偏移量
  
  - 通用事件
  

http://git-wip-us.apache.org/repos/asf/incubator-weex/blob/5675ef71/doc/source/cn/references/components/slider.md
----------------------------------------------------------------------
diff --cc doc/source/cn/references/components/slider.md
index c07734b,049ff06..0a23c2e
--- a/doc/source/cn/references/components/slider.md
+++ b/doc/source/cn/references/components/slider.md
@@@ -22,10 -22,8 +22,8 @@@ version: 2.
    该值决定是否自动播放轮播。重置 `loadmore` 相关的 
UI，值不一样就会重置。
  
  - `interval {number}`：值为毫秒数，此值设定 slider 
切换时间间隔。当 `auto-play` 值为 `true` 时生效。
--
 +- `infinite {boolean}`：循环播放，可选值为 
`true`/`false`，默认的是 `true`。
- 
- - `offset-x-accuracy {float}`：设定 
`scroll`事件触发精度，精度数值代表滚动距离占
一页宽度的比例。
+ - `offset-x-accuracy {number}`<sup 
class="wx-v">0.11+</sup>：控制`onscroll`事件触发的频率，默认值为10，表示两次`onscroll`事件之间Slider
 
Page至少滚动了10px。注意，将该值设置为较小的数值会提高滚动事件采æ
 ·çš„精度，但同时也会降低页面的性能。
  
  ## 样式
  
@@@ -45,10 -43,12 +43,11 @@@
  
    事件中 event 对象属性：
    - `index`：展示的图片索引
- 
- - `scroll` <sup 
class="wx-v">0.11+</sup>：滚动时触发这个事件。此事件回调中会给出当前`offsetXRatio`值。
--
 -- `onscroll` <sup class="wx-v">0.11+</sup>: 
列表发生滚动时将会触发该事件，事件的默认抽æ 
·çŽ‡ä¸º10px，即列表每滚动10px触发一次，可通过属性`offset-accuracy`设置抽æ
 ·çŽ‡ã€‚    
 -  
++  - `scroll` <sup class="wx-v">0.11+</sup>: 
列表发生滚动时将会触发该事件，事件的默认抽æ 
·çŽ‡ä¸º10px，即列表每滚动10px触发一次，可通过属性`offset-accuracy`设置抽æ
 ·çŽ‡ã€‚    
 +  [体验一下](http://dotwe.org/vue/832e8f50cc325975b9d3aba93a9f6c39)
+   事件中 event 对象属性：  
+   - `offsetXRatio 
{number}`：表示当前页面的偏移比例，取值范围为[-1, 
1]，负值表示向左侧滚动，正值向右。例如，`-0.2`表示当前item有20%的区域被滚动到slider左侧边界以外，`0.3`表示当前item有30%的区域被滚动到slider右侧边界以外。
+ 
  
  - 通用事件
  

http://git-wip-us.apache.org/repos/asf/incubator-weex/blob/5675ef71/doc/source/cn/references/modules/dom.md
----------------------------------------------------------------------
diff --cc doc/source/cn/references/modules/dom.md
index 6028de0,ed4f1c2..71a4bd9
--- a/doc/source/cn/references/modules/dom.md
+++ b/doc/source/cn/references/modules/dom.md
@@@ -29,8 -29,9 +29,9 @@@ version: 2.
  #### 参数
  - `node {Node}`：你要滚动到的那个节点
  - `options {Object}`：如下选项
--  - `offset {number}`：一个到其可见位置的偏移距离，默认是 
`0`
-  - `animated {bool}`：设置是否有滚动动画，默认是 true
 -  - `animated {boolean}` <sup 
class="wx-v">0.10+</sup>：是否需要附带滚动动画，默认是`true`
++- `offset {number}`：一个到其可见位置的偏移距离，默认是 `0`
++- `animated {boolean}` <sup 
class="wx-v">0.10+</sup>：是否需要附带滚动动画，默认是`true`
+ 
  #### 示例
  
  ```html