diff --git a/components/affix/index.md b/components/affix/index.md index f9c572c7b2..89c2af0c05 100644 --- a/components/affix/index.md +++ b/components/affix/index.md @@ -1,14 +1,21 @@ # Affix - category: Components -- chinese: 固定 +- chinese: 固钉 --- +将页面元素钉在可视范围。 + +## 何时使用 + +当内容区域比较长,需要滚动页面时,这部分内容对应的操作或者导航需要在滚动范围内始终展现。常用于侧边菜单和按钮组合。 + +页面可视范围过小时,慎用此功能以免遮挡页面内容。 + ## API -属性如下 | 成员 | 说明 | 类型 | 默认值 | |-------------|----------------|--------------------|--------------| -| offset | 达到指定偏移量后触发 | Number | 0 | +| offset | 达到指定偏移量后触发 | Number | 0 | diff --git a/components/alert/index.md b/components/alert/index.md index e2b5ec4a69..2662d9efcf 100644 --- a/components/alert/index.md +++ b/components/alert/index.md @@ -9,8 +9,8 @@ ## 何时使用 -- 当系统需要向用户显示警告的信息时。 -- 始终展现,不会自动消失,用户可以点击关闭。 +- 当某个页面需要向用户显示警告的信息时。 +- 非浮层的静态展现形式,始终展现,不会自动消失,用户可以点击关闭。 ## API diff --git a/components/carousel/index.md b/components/carousel/index.md index a0944e0a40..03c6bb4cc2 100644 --- a/components/carousel/index.md +++ b/components/carousel/index.md @@ -5,10 +5,13 @@ --- -旋转木马,轮播组件。 +旋转木马,一组轮播的区域。 ## 何时使用 +- 当有一组平级的内容。 +- 当内容空间不足时,可以用走马灯的形式进行收纳,进行轮播展现。 +- 常用于一组图片或卡片轮播。 ## API diff --git a/components/notification/index.md b/components/notification/index.md index 62727786be..9d27a255e0 100644 --- a/components/notification/index.md +++ b/components/notification/index.md @@ -9,7 +9,11 @@ ## 何时使用 -- 当系统需要在窗口右上角显示通知提醒信息时。 +在系统右上角显示通知提醒信息。经常用于以下情况: + +- 较为复杂的通知内容。 +- 带有交互的通知,给出用户下一步的行动点。 +- 系统主动推送。 ## API diff --git a/components/tree/index.md b/components/tree/index.md index 5853657c38..a21620d1ac 100644 --- a/components/tree/index.md +++ b/components/tree/index.md @@ -1,8 +1,12 @@ # Tree - category: Components -- chinese: 树形控件 +- chinese: 树 --- +树形控件。 +## 何时使用 + +文件夹、组织架构、生物分类、国家地区等等,人间万物的大多数结构都是树形结构。使用`树控件`可以完整展现其中的层级关系,并具有展开收起选择等交互功能。 diff --git a/components/upload/index.md b/components/upload/index.md index df9009aeeb..f46a33a5c8 100644 --- a/components/upload/index.md +++ b/components/upload/index.md @@ -5,4 +5,10 @@ --- +文件选择上传和拖拽上传控件。 +## 何时使用 + +- 当需要上传一个或一些文件时。 +- 当需要展现上传的进度时。 +- 当需要使用拖拽交互时。 diff --git a/components/validation/index.md b/components/validation/index.md index e55e1580ac..c13c6dc82b 100644 --- a/components/validation/index.md +++ b/components/validation/index.md @@ -10,7 +10,7 @@ ## 何时使用 -同表单结合使用,对表单域进行校验。 +同表单结合使用,对表单域进行校验,提供前台校验和后天实时反馈校验,并对表单错误提供有效信息提示。 ## API