diff --git a/components/dropdown/demo/index.vue b/components/dropdown/demo/index.vue
index 0ea3c7fa3..6b581f941 100644
--- a/components/dropdown/demo/index.vue
+++ b/components/dropdown/demo/index.vue
@@ -19,9 +19,15 @@ const md = {
us: `# Dropdown
A dropdown list.
## When To Use
- If there are too many operations to display, you can wrap them in a \`Dropdown\`. By clicking/hovering on the trigger, a dropdown menu should appear, which allows you to choose one option and execute relevant actions.`,
+ If there are too many operations to display, you can wrap them in a \`Dropdown\`. By clicking/hovering on the trigger, a dropdown menu should appear, which allows you to choose one option and execute relevant actions.
+ ## Examples
+ `,
}
export default {
+ category: 'Components',
+ subtitle: '下拉菜单',
+ type: 'Navigation',
+ title: 'Dropdown',
render () {
return (
diff --git a/components/grid/demo/index.vue b/components/grid/demo/index.vue
index bca5e182b..ede56aac1 100644
--- a/components/grid/demo/index.vue
+++ b/components/grid/demo/index.vue
@@ -53,6 +53,7 @@ Following is a brief look at how it works:
## Flex layout
Our grid systems support Flex layout to allow the elements within the parent to be aligned horizontally - left, center, right, wide arrangement, and decentralized arrangement. The Grid system also supports vertical alignment - top aligned, vertically centered, bottom-aligned. You can also define the order of elements by using \`order\`.
Flex layout uses a 24 grid layout to define the width of each "box", but does not rigidly adhere to the grid layout.
+## Examples
`,
}
export default {
diff --git a/components/index.js b/components/index.js
index 5419e5ea8..454ef9d6a 100644
--- a/components/index.js
+++ b/components/index.js
@@ -95,11 +95,7 @@ export { default as Modal } from './modal'
export { default as Alert } from './alert'
export { default as TimePicker } from './time-picker'
-const api = {
- notification,
- message,
-}
-export { api, notification, message }
+export { notification, message }
import Steps from './steps'
const { Step } = Steps
diff --git a/components/input/demo/index.vue b/components/input/demo/index.vue
index 0e87f5762..23d502dc1 100644
--- a/components/input/demo/index.vue
+++ b/components/input/demo/index.vue
@@ -22,7 +22,8 @@ const md = {
Keyboard and mouse can be used for providing or changing data.
## When To Use
- A user input in a form field is needed.
-- A search input is required. `,
+- A search input is required.
+## Examples `,
}
export default {
category: 'Components',
diff --git a/components/menu/demo/horizontal.md b/components/menu/demo/horizontal.md
new file mode 100644
index 000000000..750494ba8
--- /dev/null
+++ b/components/menu/demo/horizontal.md
@@ -0,0 +1,50 @@
+
+#### 顶部导航
+水平的顶部导航菜单。
+
+
+
+#### Top Navigation
+Horizontal top navigation menu.
+
+
+```html
+
+
+
+
+ Navigation One
+
+
+ Navigation Two
+
+
+ Navigation Three - Submenu
+
+ Option 1
+ Option 2
+
+
+ Option 3
+ Option 4
+
+
+
+ Navigation Four - Link
+
+
+
+
+
+```
diff --git a/components/menu/demo/horizontal.vue b/components/menu/demo/horizontal.vue
deleted file mode 100644
index c3a012642..000000000
--- a/components/menu/demo/horizontal.vue
+++ /dev/null
@@ -1,54 +0,0 @@
-
-
-
- ## 顶部导航
- 水平的顶部导航菜单。
-
-
-
-
-
diff --git a/components/menu/demo/index.vue b/components/menu/demo/index.vue
index af35e6af9..2b0a91b6b 100644
--- a/components/menu/demo/index.vue
+++ b/components/menu/demo/index.vue
@@ -1,13 +1,3 @@
-
-
-
-
-
-
-
-
-
-
+
+
diff --git a/components/menu/demo/inline-collapsed.md b/components/menu/demo/inline-collapsed.md
new file mode 100644
index 000000000..5057490b8
--- /dev/null
+++ b/components/menu/demo/inline-collapsed.md
@@ -0,0 +1,70 @@
+
+#### 缩起内嵌菜单
+内嵌菜单可以被缩起/展开。
+
+
+
+#### Collapsed inline menu
+Inline menu could be collapsed.
+
+
+```html
+
+
+
+
+
+
+
+
+ Option 1
+
+
+
+ Option 2
+
+
+
+ Option 3
+
+
+ Navigation One
+ Option 5
+ Option 6
+ Option 7
+ Option 8
+
+
+ Navigation Two
+ Option 9
+ Option 10
+
+ Option 11
+ Option 12
+
+
+
+
+
+
+
+```
\ No newline at end of file
diff --git a/components/menu/demo/inline-collapsed.vue b/components/menu/demo/inline-collapsed.vue
deleted file mode 100644
index 95f82884a..000000000
--- a/components/menu/demo/inline-collapsed.vue
+++ /dev/null
@@ -1,77 +0,0 @@
-
-
-
- ## 缩起内嵌菜单
- 内嵌菜单可以被缩起/展开。
- 你可以在 [Layout](/components/layout/#components-layout-demo-side) 里查看侧边布局结合的完整示例。
-
-
-
-
-
-
-
-
-
-
diff --git a/components/menu/demo/inline.md b/components/menu/demo/inline.md
new file mode 100644
index 000000000..90855e441
--- /dev/null
+++ b/components/menu/demo/inline.md
@@ -0,0 +1,76 @@
+
+#### 内嵌菜单
+垂直菜单,子菜单内嵌在菜单区域。
+
+
+
+#### Inline menu
+Vertical menu with inline submenus.
+
+
+```html
+
+
+
+
+ Navigation One
+
+ Item 1
+ Option 1
+ Option 2
+
+
+ Option 3
+ Option 4
+
+
+
+ Navigation Two
+ Option 5
+ Option 6
+
+ Option 7
+ Option 8
+
+
+
+ Navigation Three
+ Option 9
+ Option 10
+ Option 11
+ Option 12
+
+
+
+
+
+```
diff --git a/components/menu/demo/inline.vue b/components/menu/demo/inline.vue
deleted file mode 100644
index bfefcda9d..000000000
--- a/components/menu/demo/inline.vue
+++ /dev/null
@@ -1,79 +0,0 @@
-
-
-
- ## 内嵌菜单
- 垂直菜单,子菜单内嵌在菜单区域。
-
-
-
-
-
diff --git a/components/menu/demo/sider-current.md b/components/menu/demo/sider-current.md
new file mode 100644
index 000000000..8f71c9ef2
--- /dev/null
+++ b/components/menu/demo/sider-current.md
@@ -0,0 +1,67 @@
+
+#### 只展开当前父级菜单
+点击菜单,收起其他展开的所有菜单,保持菜单聚焦简洁。
+
+
+
+#### Open current submenu only
+Click the menu and you will see that all the other menus gets collapsed to keep the entire menu compact.
+
+
+```html
+
+
+
+
+ Navigation One
+ Option 1
+ Option 2
+ Option 3
+ Option 4
+
+
+ Navigation Two
+ Option 5
+ Option 6
+
+ Option 7
+ Option 8
+
+
+
+ Navigation Three
+ Option 9
+ Option 10
+ Option 11
+ Option 12
+
+
+
+
+
+```
diff --git a/components/menu/demo/sider-current.vue b/components/menu/demo/sider-current.vue
deleted file mode 100644
index d93ba5c3d..000000000
--- a/components/menu/demo/sider-current.vue
+++ /dev/null
@@ -1,70 +0,0 @@
-
-
-
- ## 只展开当前父级菜单
- 点击菜单,收起其他展开的所有菜单,保持菜单聚焦简洁。
-
-
-
-
-
diff --git a/components/menu/demo/switch-mode.md b/components/menu/demo/switch-mode.md
new file mode 100644
index 000000000..e0ed211ce
--- /dev/null
+++ b/components/menu/demo/switch-mode.md
@@ -0,0 +1,72 @@
+
+#### 切换菜单类型
+展示动态切换模式。
+
+
+
+#### Switch the menu type
+Show the dynamic switching mode (between 'inline' and 'vertical').
+
+
+```html
+
+
+
Change Mode
+
+
Change Theme
+
+
+
+
+
+ Navigation One
+
+
+
+ Navigation Two
+
+
+ Navigation Three
+ Option 3
+ Option 4
+
+ Option 5
+ Option 6
+
+
+
+ Navigation Four
+ Option 7
+ Option 8
+ Option 9
+ Option 10
+
+
+
+
+
+```
diff --git a/components/menu/demo/switch-mode.vue b/components/menu/demo/switch-mode.vue
deleted file mode 100644
index 70369031c..000000000
--- a/components/menu/demo/switch-mode.vue
+++ /dev/null
@@ -1,76 +0,0 @@
-
-
-
- ## 切换菜单类型
- 展示动态切换模式。
-
-
Change Mode
-
-
Change Theme
-
-
-
-
-
-
diff --git a/components/menu/demo/theme.md b/components/menu/demo/theme.md
new file mode 100644
index 000000000..aca258203
--- /dev/null
+++ b/components/menu/demo/theme.md
@@ -0,0 +1,77 @@
+
+#### 主题
+内建了两套主题 `light|dark`,默认 `light`。
+
+
+
+#### Menu Themes
+There are two built-in themes: 'light' and 'dark'. The default value is 'light'.
+
+
+```html
+
+
+
+ ## 主题
+ 内建了两套主题 `light|dark`,默认 `light`。
+
+
Change Theme
+
+
+
+
+
+ Navigation One
+
+
+
+ Navigation Two
+
+
+ Navigation Three
+ Option 3
+ Option 4
+
+ Option 5
+ Option 6
+
+
+
+ Navigation Four
+ Option 7
+ Option 8
+ Option 9
+ Option 10
+
+
+
+
+
+```
diff --git a/components/menu/demo/theme.vue b/components/menu/demo/theme.vue
deleted file mode 100644
index 15352d49d..000000000
--- a/components/menu/demo/theme.vue
+++ /dev/null
@@ -1,77 +0,0 @@
-
-
-
- ## 主题
- 内建了两套主题 `light|dark`,默认 `light`。
-
-
Change Theme
-
-
-
-
-
-
diff --git a/components/menu/demo/vertical.md b/components/menu/demo/vertical.md
new file mode 100644
index 000000000..89b516ada
--- /dev/null
+++ b/components/menu/demo/vertical.md
@@ -0,0 +1,56 @@
+
+#### 垂直菜单
+子菜单是弹出的形式。
+
+
+
+#### Vertical menu
+Submenus open as pop-ups.
+
+
+```html
+
+
+
+
+
+ Navigation One
+
+
+
+ Navigation Two
+
+
+ Navigation Three
+ Option 3
+ Option 4
+
+ Option 5
+ Option 6
+
+
+
+ Navigation Four
+ Option 7
+ Option 8
+ Option 9
+ Option 10
+
+
+
+
+
+```
diff --git a/components/menu/demo/vertical.vue b/components/menu/demo/vertical.vue
deleted file mode 100644
index 7fa24c7a0..000000000
--- a/components/menu/demo/vertical.vue
+++ /dev/null
@@ -1,60 +0,0 @@
-
-
-
- ## 垂直菜单
- 子菜单是弹出的形式。
-
-
-
-
-
diff --git a/components/menu/index.en-US.md b/components/menu/index.en-US.md
new file mode 100644
index 000000000..390da0b10
--- /dev/null
+++ b/components/menu/index.en-US.md
@@ -0,0 +1,73 @@
+
+## API
+
+````html
+
+
+ 菜单项
+
+ 子菜单项
+
+
+
+````
+
+### Menu
+
+| Param | Description | Type | Default value |
+| ----- | ----------- | ---- | ------------- |
+| defaultOpenKeys | array with the keys of default opened sub menus | | |
+| defaultSelectedKeys | array with the keys of default selected menu items | string\[] | |
+| forceSubMenuRender | render submenu into DOM before it shows | boolean | false |
+| inlineCollapsed | specifies the collapsed status when menu is inline mode | boolean | - |
+| inlineIndent | indent px of inline menu item on each level | number | 24 |
+| mode | type of the menu; `vertical`, `horizontal`, and `inline` modes are supported | string: `vertical` \| `vertical-right` \| `horizontal` \| `inline` | `vertical` |
+| multiple | Allow selection of multiple items | boolean | false |
+| openKeys(.sync) | array with the keys of currently opened sub menus | string\[] | |
+| selectable | allow selecting menu items | boolean | true |
+| selectedKeys(v-model) | array with the keys of currently selected menu items | string\[] | |
+| style | style of the root node | object | |
+| subMenuCloseDelay | delay time to hide submenu when mouse leave, unit: second | number | 0.1 |
+| subMenuOpenDelay | delay time to show submenu when mouse enter, unit: second | number | 0 |
+| theme | color theme of the menu | string: `light` `dark` | `light` |
+
+### Menu Events
+| Events Name | Description | Arguments |
+| --- | --- | --- |
+| click | callback executed when a menu item is clicked | function({ item, key, keyPath }) |
+| deselect | callback executed when a menu item is deselected, only supported for multiple mode | function({ item, key, selectedKeys }) |
+| openChange | called when open/close sub menu | function(openKeys: string\[]) |
+| select | callback executed when a menu item is selected | function({ item, key, selectedKeys }) |
+
+
+### Menu.Item
+
+| Param | Description | Type | Default value |
+| ----- | ----------- | ---- | ------------- |
+| disabled | whether menu item is disabled or not | boolean | false |
+| key | unique id of the menu item | string | |
+
+### Menu.SubMenu
+
+| Param | Description | Type | Default value |
+| ----- | ----------- | ---- | ------------- |
+| children | sub menus or sub menu items | Array<MenuItem\|SubMenu> | |
+| disabled | whether sub menu is disabled or not | boolean | false |
+| key | unique id of the sub menu | string | |
+| title | title of the sub menu | string\|ReactNode | |
+
+### Menu.SubMenu Events
+| Events Name | Description | Arguments |
+| --- | --- | --- |
+| titleClick | callback executed when the sub menu title is clicked | function({ key, domEvent }) |
+
+### Menu.ItemGroup
+
+| Param | Description | Type | Default value |
+| ----- | ----------- | ---- | ------------- |
+| children | sub menu items | MenuItem\[] | |
+| title | title of the group | string\|ReactNode | |
+
+### Menu.Divider
+
+Divider line in between menu items, only used in vertical popup Menu or Dropdown Menu.
diff --git a/components/menu/index.zh-CN.md b/components/menu/index.zh-CN.md
index d9334de2c..1b9c65d17 100644
--- a/components/menu/index.zh-CN.md
+++ b/components/menu/index.zh-CN.md
@@ -1,29 +1,16 @@
----
-category: Components
-cols: 1
-type: Navigation
-title: Menu
-subtitle: 导航菜单
----
-
-为页面和功能提供导航的菜单列表。
-
-## 何时使用
-
-导航菜单是一个网站的灵魂,用户依赖导航在各个页面中进行跳转。一般分为顶部导航和侧边导航,顶部导航提供全局性的类目和功能,侧边导航提供多级结构来收纳和排列网站架构。
-
-更多布局和导航的使用可以参考:[通用布局](/components/layout)。
## API
-```html
-
-```
+````html
+
+
+ 菜单项
+
+ 子菜单项
+
+
+
+````
### Menu
diff --git a/components/message/demo/duration.md b/components/message/demo/duration.md
index 53f086364..01379b818 100644
--- a/components/message/demo/duration.md
+++ b/components/message/demo/duration.md
@@ -14,13 +14,14 @@ Customize message display duration from default `3s` to `10s`.
Customized display duration
```
diff --git a/components/message/demo/index.vue b/components/message/demo/index.vue
index c9fe688aa..7cbe8432a 100644
--- a/components/message/demo/index.vue
+++ b/components/message/demo/index.vue
@@ -17,9 +17,15 @@ const md = {
Display global messages as feedback in response to user operations.
## When To Use
- To provide feedback such as success, warning, error etc.
-- A message is displayed at top and center and will be dismissed automatically, as a non-interrupting light-weighted prompt.`,
+- A message is displayed at top and center and will be dismissed automatically, as a non-interrupting light-weighted prompt.
+## Examples `,
}
export default {
+ category: 'Components',
+ subtitle: '全局提示',
+ type: 'Feedback',
+ noinstant: true,
+ title: 'Message',
render () {
return (
diff --git a/components/message/demo/info.md b/components/message/demo/info.md
index 88a7e5763..8d6cd46a0 100644
--- a/components/message/demo/info.md
+++ b/components/message/demo/info.md
@@ -14,10 +14,11 @@ Normal messages as feedbacks.
Display normal message