From f1047cb8550dce65ae2191ee77333db25b7a0bf1 Mon Sep 17 00:00:00 2001
From: Justineo <justice360@gmail.com>
Date: Thu, 3 Dec 2020 10:38:42 +0800
Subject: [PATCH] docs: add further description for dialog size and dimension
 variants

---
 one/docs/components/dialog.md       | 2 ++
 one/docs/demo/dialog/size.vue       | 8 ++++++++
 one/docs/en-US/components/dialog.md | 6 ++++++
 3 files changed, 16 insertions(+)

diff --git a/one/docs/components/dialog.md b/one/docs/components/dialog.md
index 0adef56..856e6f3 100644
--- a/one/docs/components/dialog.md
+++ b/one/docs/components/dialog.md
@@ -4,6 +4,8 @@
 
 ### 尺寸与全屏
 
+可选的 `ui` 属性值：`s`/`m`/`narrow`/`medium`/`wide`/`auto`。
+
 [[ demo src="/demo/dialog/size.vue" ]]
 
 ### 模态与非模态
diff --git a/one/docs/demo/dialog/size.vue b/one/docs/demo/dialog/size.vue
index 6d25acc..60c71d4 100644
--- a/one/docs/demo/dialog/size.vue
+++ b/one/docs/demo/dialog/size.vue
@@ -64,3 +64,11 @@ export default {
   margin-right: 20px;
 }
 </style>
+
+<docs>
+`s`/`m` 用于指定内容的尺寸，会被继承到内部的组件上。而 `narrow`/`medium`/`wide`/`fullscreen`/`auto` 是对话框本身所占区域的大小，可以与 `s`/`m` 混合使用。
+</docs>
+
+<docs locale="en-US">
+`s`/`m` are used to specify size for internal content and will be inherited by components inside the dialog. While `narrow`/`medium`/`wide`/`fullscreen`/`auto` are used to specify the dimension of the dialog itself, thus can be used together with `s`/`m`.
+</docs>
diff --git a/one/docs/en-US/components/dialog.md b/one/docs/en-US/components/dialog.md
index 9a907ec..3e1b9de 100644
--- a/one/docs/en-US/components/dialog.md
+++ b/one/docs/en-US/components/dialog.md
@@ -2,6 +2,12 @@
 
 ## Demos
 
+### Sizes and fullscreen
+
+Available size/dimension variants for the `ui` prop: `s`/`m`/`narrow`/`medium`/`wide`/`auto`.
+
+[[ demo src="/demo/dialog/size.vue" ]]
+
 ### Modal and non-modal
 
 [[ demo src="/demo/dialog/modal.vue" ]]