zshshr closed pull request #231: update doc for div
URL: https://github.com/apache/incubator-weex-site/pull/231
 
 
   

This is a PR merged from a forked repository.
As GitHub hides the original diff on merge, it is displayed below for
the sake of provenance:

As this is a foreign pull request (from a fork), the diff is supplied
below (as it won't show otherwise due to GitHub magic):

diff --git a/docs/docs/components/div.md b/docs/docs/components/div.md
index 8c19cbc37..6e3807903 100644
--- a/docs/docs/components/div.md
+++ b/docs/docs/components/div.md
@@ -1,27 +1,46 @@
----
-sidebarDepth: 0
----
-# <div>
-
-`<div>` 组件是用于包装其它组件的最基本容器。支持所有的通用样式、特性、flexbox 布局。其类似于 HTML 的 `<div>` 
容器,但不能直接在里面添加文本(字符串),如果要展示文本,应该使用 `<text>` 组件。
-
-``` vue{2}
-<template>
-  <div>
-    <text>Hello World!</text>
-  </div>
-</template>
-```
-
-::: warning 注意
-* 不能直接在 `<div>` 中添加文本。
-* `<div>` 在 native 中不可滚动,即使显式设置高度也一样。
-* `<div>` 嵌套层级不可过深,否则容易引起性能问题,建议控制在 10 层以内。
-:::
-
-## 子组件
-`<div>` 是基本容器组件,支持包括 `<div>` 在内的任何组件作为自己的子组件。
-
-## Demo
-[&lt;div&gt; 
在native中不可滚动](http://dotwe.org/vue/57cc2dd8955b0ead3e5b46e3df2f58b9)  
-滚动页面,需要使用 
[&lt;list&gt;](/docs/list.html)、[&lt;scroller&gt;](/docs/scroller.html) 组件实现。
\ No newline at end of file
+# Introduction
+
+`<div>` is a base container component.support all 
+
+- [common attributes](/wiki/common-attributes.html).
+- [common styles](/wiki/common-styles.html)
+- [common events](/wiki/common-events.html)
+- flexbox layout
+
+similar to `div` in `html`
+
+## Child Components
+
+`<div>` is base container component ,support all compenents as child (include 
`div` self)
+
+## Attributes
+
+* **common attributes**. Check out [common 
attributes](/wiki/common-attributes.html).
+
+## Styles
+
+* **common styles**. Check out [common styles](/wiki/common-styles.html).
+
+## Events
+* **common events**. Check out the [common events](/wiki/common-events.html).
+
+## Other
+
+* don't add text in `<div>`directly。if need show text, use `<text>`,see Example
+* `<div>` can't scroll automatic in native. even component's height above 
screen's height
+* `<div>` for good performance,depth level don't be too deep, suggest __depth 
level < 14__
+
+## Example
+
+
+- code 
+
+       ``` vue{2}
+       <template>
+       <div>
+       <text>Hello World!</text>
+       </div>
+       </template>
+       ```
+
+- [try it](http://dotwe.org/vue/57cc2dd8955b0ead3e5b46e3df2f58b9) (naitve 
can't scroll automatic)you scan use 
[&lt;list&gt;](/docs/list.html)、[&lt;scroller&gt;](/docs/scroller.html) for 
scroll
\ No newline at end of file
diff --git a/docs/zh/docs/components/div.md b/docs/zh/docs/components/div.md
index 8c19cbc37..86b965f09 100644
--- a/docs/zh/docs/components/div.md
+++ b/docs/zh/docs/components/div.md
@@ -1,9 +1,30 @@
----
-sidebarDepth: 0
----
-# &lt;div&gt;
+# 简介
 
-`<div>` 组件是用于包装其它组件的最基本容器。支持所有的通用样式、特性、flexbox 布局。其类似于 HTML 的 `<div>` 
容器,但不能直接在里面添加文本(字符串),如果要展示文本,应该使用 `<text>` 组件。
+`<div>` 组件是用于包装其它组件的最基本容器。支持所有的通用样式、特性、flexbox 布局。其类似于 HTML 的 `<div>` 容器,
+
+## 子组件
+
+`<div>` 是基本容器组件,支持包括 `<div>` 在内的任何组件作为自己的子组件。
+
+## 属性
+
+* **通用属性**. 参见[通用属性](/wiki/common-attributes.html).
+
+## 样式
+
+* **通用样式**. 参见[通用样式](/wiki/common-styles.html).
+
+## 事件
+
+* **通用事件**. 参见[通用事件](/wiki/common-events.html).
+
+## 其它
+
+* 不能直接在 `<div>` 中添加文本。如果要展示文本,应该使用 `<text>` 组件。
+* `<div>` 在 native 中不可滚动,即使显式设置高度也一样。
+* `<div>` 为了有一个好的性能,嵌套层级不宜过深,建议 __深度<14层__ 。
+
+## 例子
 
 ``` vue{2}
 <template>
@@ -13,15 +34,4 @@ sidebarDepth: 0
 </template>
 ```
 
-::: warning 注意
-* 不能直接在 `<div>` 中添加文本。
-* `<div>` 在 native 中不可滚动,即使显式设置高度也一样。
-* `<div>` 嵌套层级不可过深,否则容易引起性能问题,建议控制在 10 层以内。
-:::
-
-## 子组件
-`<div>` 是基本容器组件,支持包括 `<div>` 在内的任何组件作为自己的子组件。
-
-## Demo
-[&lt;div&gt; 
在native中不可滚动](http://dotwe.org/vue/57cc2dd8955b0ead3e5b46e3df2f58b9)  
-滚动页面,需要使用 
[&lt;list&gt;](/docs/list.html)、[&lt;scroller&gt;](/docs/scroller.html) 组件实现。
\ No newline at end of file
+- [运行case](http://dotwe.org/vue/57cc2dd8955b0ead3e5b46e3df2f58b9) (naitve 
不可滚动)需要使用 
[&lt;list&gt;](/docs/list.html)、[&lt;scroller&gt;](/docs/scroller.html) 组件实现。


 

----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on GitHub and use the
URL above to go to the specific comment.
 
For queries about this service, please contact Infrastructure at:
us...@infra.apache.org


With regards,
Apache Git Services

Reply via email to