* [doc] Add doc for scroller, which exists in 
https://github.com/alibaba/weex/blob/doc/doc/components/scroller.md#attributes 
, and disappears for a reason that no one knows.


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

Branch: refs/heads/master
Commit: 6dc87a74fabb014f08e2e7dccd501bbf51e5e4d1
Parents: 18aa8f0
Author: YorkShen <[email protected]>
Authored: Thu Mar 2 17:00:44 2017 +0800
Committer: YorkShen <[email protected]>
Committed: Thu Mar 2 17:00:44 2017 +0800

----------------------------------------------------------------------
 doc/source/cn/references/components/scroller.md | 4 ++++
 doc/source/references/components/scroller.md    | 4 ++++
 2 files changed, 8 insertions(+)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/incubator-weex/blob/6dc87a74/doc/source/cn/references/components/scroller.md
----------------------------------------------------------------------
diff --git a/doc/source/cn/references/components/scroller.md 
b/doc/source/cn/references/components/scroller.md
index 4bb9f4b..694ce87 100644
--- a/doc/source/cn/references/components/scroller.md
+++ b/doc/source/cn/references/components/scroller.md
@@ -33,6 +33,10 @@ version: 2.1
 
 - `show-scrollbar {boolean}`:可选值为 `true`/ `false`,默认值为 
`true`。控制是否出现滚动条。
 - `scroll-direction {string}`:可选为 `horizontal` 或者 
`vertical`,默认值为 `vertical` 。定义滚动的方向。
+  - 
`scroll-direction`定义了scroller的滚动方向,`flex-direction`定义了scroller的布局方向,两个方向å¿
…须一致。
+  - 
`scroll-direction`的默认值是`vertical`,`flex-direction`的默认值是`row`。
+  - 
当需要一个水平方向的scroller时,使用`scroll-direction:horizontal`和`flex-direction:
 row`。
+  - 
当需要一个竖直方向的scroller时,使用`scroll-direction:vertical`和`flex-direction:
 
column`。由于这两个值均是默认值,当需要一个竖直方向的scroller时,这两个值可以不设置。
 - `loadmoreoffset {number}`:默认值为 0,触发 `loadmore` 
事件所需要的垂直偏移距离(设备屏幕底部与页面底部之间的距离)。当页面的滚动条滚动到足够接近页面底部时将会触发
 `loadmore` 这个事件。
 
   ![mobile_preview](../images/scroller_1.jpg)

http://git-wip-us.apache.org/repos/asf/incubator-weex/blob/6dc87a74/doc/source/references/components/scroller.md
----------------------------------------------------------------------
diff --git a/doc/source/references/components/scroller.md 
b/doc/source/references/components/scroller.md
index 1b65907..2f637d0 100644
--- a/doc/source/references/components/scroller.md
+++ b/doc/source/references/components/scroller.md
@@ -27,6 +27,10 @@ And there are two special components that can only be used 
inside scroller compo
 
 * show-scrollbar: true/false whether show the scroll bar or not, default value 
is true
 * scroll-direction: <string> define scroll direction of component, horizontal 
or vertical
+  * `scroll-direction` defines the scrollable axis of scroller and 
`flex-direction` defines the layout axis of scroller. `scroll-direction` and 
`flex-direction` must be set to the same direction, otherwise, undefined 
behavior may happen.
+  * Default value for `scroll-direction` is vertical, and for `flex-direction` 
is row .
+  * Use `scroll-direction:horizontal` and `flex-direction: row` when a 
horizontal layout and scrollable scroller is expected.
+  * Use `scroll-direction:vertical` and `flex-direction: column` when a 
vertical layout and scrollable scroller is expected. But thoes two values are 
default, if you don't set them, it also works fine.
 * loadmoreoffset : <number> default value is 0. The loadmore event will be 
triggered when the list is loadmoreoffset left to reach the bottom of the list 
view. e.g. a list has total content length of 1000, and the loadmoreoffset is 
set to 400, the loadmore event will be triggered when 600 has beed scrolled and 
there is less than 400 left.
 * loadmoreretry : <number> default value 0,whether to reset loadmore related 
UI when loadmore failed, will be deprecated in further release.
 

Reply via email to