-
diff --git a/components/button/demo/button-group.vue b/components/button/demo/button-group.md
similarity index 74%
rename from components/button/demo/button-group.vue
rename to components/button/demo/button-group.md
index 678fff8d5..78c14db1c 100644
--- a/components/button/demo/button-group.vue
+++ b/components/button/demo/button-group.md
@@ -1,3 +1,16 @@
+
+#### 按钮组合
+可以将多个 `Button` 放入 `Button.Group` 的容器中。
+通过设置 `size` 为 `large` `small` 分别把按钮组合设为大、小尺寸。若不设置 `size`,则尺寸为中。
+
+
+
+#### Button Group
+Buttons can be grouped by placing multiple `Button` components into a `Button.Group`.
+The `size` can be set to `large`, `small` or left unset resulting in a default size.
+
+
+```html
Basic
@@ -46,3 +59,4 @@
margin-right: 8px;
}
+```
diff --git a/components/button/demo/disabled.vue b/components/button/demo/disabled.md
similarity index 65%
rename from components/button/demo/disabled.vue
rename to components/button/demo/disabled.md
index 4703665c8..081e3e83f 100644
--- a/components/button/demo/disabled.vue
+++ b/components/button/demo/disabled.md
@@ -1,3 +1,15 @@
+
+
+#### 不可用状态
+添加 `disabled` 属性即可让按钮处于不可用状态,同时按钮样式也会改变。
+
+
+
+#### Disabled
+To mark a button as disabled, add the `disabled` property to the `Button`.
+
+
+```html
Primary
@@ -13,3 +25,4 @@
Dashed(disabled)
+```
diff --git a/components/button/demo/ghost.vue b/components/button/demo/ghost.md
similarity index 53%
rename from components/button/demo/ghost.vue
rename to components/button/demo/ghost.md
index 1b837f01f..25d9a2662 100644
--- a/components/button/demo/ghost.vue
+++ b/components/button/demo/ghost.md
@@ -1,3 +1,13 @@
+
+#### 幽灵按钮
+幽灵按钮将其他按钮的内容反色,背景变为透明,常用在有色背景上。
+
+
+
+#### Ghost Button
+`ghost` property will make button's background transparent, it is common used in colored background.
+
+```html
Primary
@@ -6,3 +16,4 @@
danger
+```
diff --git a/components/button/demo/icon.md b/components/button/demo/icon.md
new file mode 100644
index 000000000..caf2b311b
--- /dev/null
+++ b/components/button/demo/icon.md
@@ -0,0 +1,26 @@
+
+#### 图标按钮
+当需要在 `Button` 内嵌入 `Icon` 时,可以设置 `icon` 属性,或者直接在 `Button` 内使用 `Icon` 组件。
+如果想控制 `Icon` 具体的位置,只能直接使用 `Icon` 组件,而非 `icon` 属性。
+
+
+
+#### Icon
+`Button` components can contain an `Icon`. This is done by setting the `icon` property or placing an `Icon` component within the `Button`
+If you want specific control over the positioning and placement of the `Icon`, then that should be done by placing the `Icon` component within the `Button` rather than using the `icon` property.
+
+
+```html
+
+
-
diff --git a/components/button/demo/loading.vue b/components/button/demo/loading.md
similarity index 74%
rename from components/button/demo/loading.vue
rename to components/button/demo/loading.md
index 81ce18b3f..3cda8a2e3 100644
--- a/components/button/demo/loading.vue
+++ b/components/button/demo/loading.md
@@ -1,3 +1,14 @@
+
+#### 加载中状态
+添加 `loading` 属性即可让按钮处于加载状态,最后两个按钮演示点击后进入加载状态。
+
+
+
+#### Loading
+A loading indicator can be added to a button by setting the `loading` property on the `Button`.
+
+
+```html
@@ -36,3 +47,4 @@ export default {
},
}
+```
diff --git a/components/button/demo/multiple.md b/components/button/demo/multiple.md
new file mode 100644
index 000000000..da4045e54
--- /dev/null
+++ b/components/button/demo/multiple.md
@@ -0,0 +1,21 @@
+
+#### 多个按钮组合
+按钮组合使用时,推荐使用1个主操作 + n 个次操作,3个以上操作时把更多操作放到 `Dropdown.Button` 中组合使用。
+
+
+
+#### Multiple Buttons
+If you need several buttons, we recommend that you use 1 primary button + n secondary buttons, and if there are more than three operations, you can group some of them into `Dropdown.Button`.
+
+
+```html
+// TODO: 依赖组件开发中
+
+
-
diff --git a/components/button/demo/size.vue b/components/button/demo/size.md
similarity index 70%
rename from components/button/demo/size.vue
rename to components/button/demo/size.md
index e1e6b65e3..0b290eaa2 100644
--- a/components/button/demo/size.vue
+++ b/components/button/demo/size.md
@@ -1,3 +1,16 @@
+
+#### 按钮尺寸
+按钮有大、中、小三种尺寸。
+通过设置 `size` 为 `large` `small` 分别把按钮设为大、小尺寸。若不设置 `size`,则尺寸为中。
+
+
+
+#### Size
+Ant Design supports a default button size as well as a large and small size.
+If a large or small button is desired, set the `size` property to either `large` or `small` respectively. Omit the `size` property for a button with the default size.
+
+
+```html
@@ -38,3 +51,4 @@ export default {
},
}
+```
\ No newline at end of file
diff --git a/components/button/index.en-US.md b/components/button/index.en-US.md
index ca62dfeed..ce51eecaf 100644
--- a/components/button/index.en-US.md
+++ b/components/button/index.en-US.md
@@ -1,15 +1,3 @@
----
-category: Components
-type: General
-title: Button
----
-
-To trigger an operation.
-
-## When To Use
-
-A button means an operation (or a series of operations). Clicking a button will trigger corresponding business logic.
-
## API
To get a customized button, just set `type`/`shape`/`size`/`loading`/`disabled`.
@@ -25,14 +13,10 @@ To get a customized button, just set `type`/`shape`/`size`/`loading`/`disabled`.
| type | can be set to `primary` `ghost` `dashed` `danger`(added in 2.7) or omitted (meaning `default`) | string | `default` |
| onClick | set the handler to handle `click` event | function | - |
+### events
+| Events Name | Description | Arguments |
+| --- | --- | --- |
+| click | handle `click` event | function(e) |
+
`` will be rendered into ``, and all the properties which are not listed above will be transferred to the `