diff --git a/uidoc/core/layout/table.md b/uidoc/core/layout/table.md
index 6c2137ab6c..5893f44a9e 100644
--- a/uidoc/core/layout/table.md
+++ b/uidoc/core/layout/table.md
@@ -1,2 +1,37 @@
-# table
+# bi.table
+
+### table作为一个列表集合存在，继承BI.Widget
+{% method %}
+[source](https://jsfiddle.net/fineui/8t2en619/)
+
+{% common %}
+```javascript
+BI.createWidget({
+  element: "body",
+  type: "bi.table",
+  items: [[]],
+  columnSize: [100, "fill", 200],
+  rowSize: [10, 30, 50, 70, 90, 110, 130],
+  hgap: 20,
+  vgap: 10
+});
+```
+
+{% endmethod %}
+
+## 参数设置
+| 参数         | 说明        | 类型           | 默认值                |
+| ---------- | --------- | ------------ | ------------------ |
+| scrolly    | 是否出现滚动条   | bool         | true               |
+| columnSize | 列项宽度      | array/number | [200, 200, 'fill'] |
+| rowSize    | 行高        | array/number | 30                 |
+| hgap       | 内部元素间纵向距离 | number       | 0                  |
+| vgap       | 内部元素间横向距离 | number       | 0                  |
+| items      | 子项        | array        | []                 |
+
+## 方法
+| 方法名      | 说明     | 用法              |
+| -------- | ------ | --------------- |
+| addItem  | 增加内容   | addItem(arr)    |
+| populate | 更换新的内容 | poplulate(item) |