diff --git a/docs/miniprogram/_design/Cell.md b/docs/miniprogram/_design/Cell.md new file mode 100644 index 0000000000..9d07a5ec62 --- /dev/null +++ b/docs/miniprogram/_design/Cell.md @@ -0,0 +1,57 @@ +# 单元格 Cell + +## 组件设计指南 + +### 常见用法 + +##### 常用作内容详情入口或功能入口的平铺陈列。 + +
+
+ +
+ +
+ +
+
+ +
+ +##### 常用作同类型同格式信息项平铺陈列。 + +
+
+ +
+
+ +### 推荐/慎用示例 + +##### 作为入口时,不建议承载过多过复杂的内容。 + +
+
+ + +
+
+ +
+ +##### 作为入口时,不建议在一个单元格内承载其他操作。 + +
+
+ + +
+
+ + + +### 相似组件 + +| 组件名 | 何时使用 | +| :----- | :----------------------------------- | +| [宫格](./grid) | 当需要展示多个功能或信息入口,且这些入口没有明显的优先级时使用。| diff --git a/docs/miniprogram/_design/Collapse.md b/docs/miniprogram/_design/Collapse.md new file mode 100644 index 0000000000..3f41991f7c --- /dev/null +++ b/docs/miniprogram/_design/Collapse.md @@ -0,0 +1,65 @@ +# 折叠面板 Collapse + +## 组件设计指南 + +### 何时使用 + +当信息较多,需要进行收纳时使用。 + +### 常见用法 + +##### 经常用于信息种类较多的页面,将相对次要的信息收纳起来,让用户能够关注到页面中的主要信息或流程。 + +
+ +
+ +
+ +##### 在展示多条内容较长的同类型信息时,通常从中抽取出关键信息作为标题,收纳在手风琴式折叠面板中,便于用户检索和查看。 + +
+
+ +
+
+ +
+ +##### 在网站中,经常使用折叠面板作为分类导航,将页面进行归类、收纳在折叠面板中,展开后可点击跳转。 + +
+ +
+ + + +### 推荐/慎用示例 + +##### 当信息层级较多时,不建议嵌套折叠面板,层级过多时建议审视信息结构或使用其它交互方式展示。 + +
+
+ + +
+
+ +
+ +##### 不建议使用右箭头作为折叠面板的展开图标,用户可能会误把它认作跳转二级页面的入口。 + +
+
+ + +
+
+ + + +### 相似组件 + +| 组件名 | 何时使用 | +| :----- | :----------------------------------- | +| [下拉菜单](./dropdown-menu) |当内容较多时,需要通过筛选快速定位某一类内容时使用。| diff --git a/docs/miniprogram/_design/DropdownMenu.md b/docs/miniprogram/_design/DropdownMenu.md new file mode 100644 index 0000000000..0312d49913 --- /dev/null +++ b/docs/miniprogram/_design/DropdownMenu.md @@ -0,0 +1,50 @@ +# 下拉菜单 DropdownMenu + +## 组件设计指南 + +### 何时使用 + +当内容较多时,需要通过筛选快速定位某一类内容时使用。 + +### 常见用法 + +##### 常用于单个维度筛选或多个维度复合筛选的场景,可进行单选或多选。 + +
+
+ +
+ +
+ +
+
+ + +### 推荐/慎用示例 + +##### 在单选的筛选场景内,建议将用户选择项替换标题显示于菜单面板内。 + +
+
+ + +
+
+ +
+ +##### 当筛选维度为多选时,建议提供重置按钮,便于用户恢复到未筛选状态。 + +
+ + +
+ + + +### 相似组件 + +| 组件名 | 何时使用 | +| :----- | :----------------------------------- | +| [选择器](./Cascader) | 当需要在有限的空间展示大量选项供用户选择时,或一组选项由递进层级构成,需要用户逐级选择使用时。| diff --git a/docs/miniprogram/_design/Footer.md b/docs/miniprogram/_design/Footer.md new file mode 100644 index 0000000000..1f309b2644 --- /dev/null +++ b/docs/miniprogram/_design/Footer.md @@ -0,0 +1,63 @@ +# 页脚 Footer + +## 组件设计指南 + +### 何时使用 + +当页面底部需要放置一些补充信息和链接时使用。 + +### 与页面布局相关 + +##### 页脚通常位于网站每个页面底部或主体内容下方的区域。 + +
+
+ +
+
+ +### 常见用法 + +##### 用于承载版权、隐私政策和使用条款等信息,它们是法律保护所需的。 + +
+
+ +
+
+ +
+ +##### 用于承载网站、产品的联系方式,便于用户在页脚查找联系信息或查找获得客户支持的方式。 + +
+
+ +
+
+ +
+ +##### 用于承载网站导航。 + +
+
+ +
+
+ +
+ +##### 用于承载相关公司/品牌列表,让用户能认知合作或者旗下的品牌/公司,并提供找到他们的方式。 + +
+
+ +
+ +
+ +
+
+ + diff --git a/docs/miniprogram/_design/Grid.md b/docs/miniprogram/_design/Grid.md new file mode 100644 index 0000000000..177a790e75 --- /dev/null +++ b/docs/miniprogram/_design/Grid.md @@ -0,0 +1,90 @@ +# 宫格 Grid + +## 组件设计指南 + +### 何时使用 + +当需要展示多个功能或信息入口,且这些入口没有明显的优先级时使用。 + +### 组件搭配使用 + +##### 可与徽标组合使用,可作为消息提示、或其它相关的数量提示。 + +
+
+ +
+
+ +### 常见用法 + +##### 通常用于金刚区、或底部标签栏等,在页面中较为醒目的位置承载主要的功能入口。 + +
+
+ +
+
+ +
+ +##### 通常承载图片、头像等信息进行展示,并作为查看相应信息的入口。 + +
+
+ +
+ +
+ +
+
+ +
+ +##### 通常用于动作面板,和头像、图标按钮相结合,承载分享、保存到本地等操作。 + +
+
+ +
+
+ + +### 推荐/慎用示例 + +##### 当在金刚区使用宫格承载功能入口时,建议梳理功能的优先级,将金刚区控制在3行以内,一些相对次要的功能可通过左右滑动的方式收纳在第二屏。 + +
+
+ + +
+ +
+ + +
+
+ +
+ +
+
+ + +
+ +
+ + +
+
+ + + +### 相似组件 + +| 组件名 | 何时使用 | +| :----- | :----------------------------------- | +| [单元格](./cell) |用于各个类别行的信息展示。| diff --git a/docs/miniprogram/_design/Popup.md b/docs/miniprogram/_design/Popup.md new file mode 100644 index 0000000000..cdafb95b2c --- /dev/null +++ b/docs/miniprogram/_design/Popup.md @@ -0,0 +1,55 @@ +# 弹出层 Popup + +## 组件设计指南 + +### 常见用法 + +##### 在筛选的场景,若筛选条件外露,通常会使用顶部弹出的弹出层;若为筛选入口,则通常触发使用右侧弹出的弹出层。 + +
+ +
+ +
+ +
+ +
+ +
+ +##### 承载页面中某个任务操作流程,通常会使用底部弹出的弹出层。 + +
+ +
+ +
+ +##### 承载重要提示且可能需要用户做出一些重要决策时,通常会使用中间弹出的弹出层。 + +
+
+ +
+
+ +
+ +##### 承载较为重要的运营活动入口(如拍脸图)时,通常会使用中间弹出的弹出层。 + +
+
+ +
+
+ +
+ +##### 承载网站、应用收折起来的导航菜单时,通常会使用左侧弹出的弹出层。 + +
+
+ +
+
diff --git a/docs/miniprogram/_design/Result.md b/docs/miniprogram/_design/Result.md index 6705d2d9c8..5c6a0997d3 100644 --- a/docs/miniprogram/_design/Result.md +++ b/docs/miniprogram/_design/Result.md @@ -54,4 +54,3 @@ | 组件名 | 何时使用 | | :----------------- | :--------------------------- | | [空状态](./empty ) | 当页面或模块数据为空时使用。 | - diff --git a/docs/miniprogram/_design/Tag.md b/docs/miniprogram/_design/Tag.md new file mode 100644 index 0000000000..054ed2642a --- /dev/null +++ b/docs/miniprogram/_design/Tag.md @@ -0,0 +1,88 @@ +# 标签 Tag + +## 组件设计指南 + +### 何时使用 + +当需要展示内容本身的属性、状态、类别、营销情况时作为纯展示使用;或者当大量的内容数据需要根据类型进行选择筛选时使用。 + +### 组件搭配使用 + +##### 与[图片](./image)组合使用,图片作为内容、商品等对象的详情入口时,可通过添加标签来展示该对象的属性、状态、类别、营销情况等。 + +
+
+ +
+ +
+ +
+
+ +
+ +##### 与[下拉菜单](./dropdown-menu)组合使用,作为菜单面板下拉后的选项,供用户进行选择。 + +
+
+ +
+
+ +### 常见用法 + +##### 常用于展示对象本身的属性、状态、类别、营销情况等信息,且仅作为展示使用。 + +
+
+ +
+ +
+ +
+
+ +
+ +##### 常用于内容数据基于某个维度或某些维度的检索、筛选。 + +
+
+ +
+ +
+ +
+
+ + +### 推荐/慎用示例 + +##### 标签颜色和字体颜色在明度、色相上要避免难以区分,保证标签的可读性。 + +
+
+ + +
+
+ +
+ +##### 标签文案需要经过概括和提炼,不建议过长。 + +
+ + +
+ + + +### 相似组件 + +| 组件名 | 何时使用 | +| :----- | :----------------------------------- | +| [徽标](./badge) | 当需要展示特定对象的状态变化或承载运营性质提示时使用。| diff --git a/docs/miniprogram/_design/TreeSelect.md b/docs/miniprogram/_design/TreeSelect.md new file mode 100644 index 0000000000..9b7f4023bd --- /dev/null +++ b/docs/miniprogram/_design/TreeSelect.md @@ -0,0 +1,28 @@ +# 树形选择器 TreeSelect + +## 组件设计指南 + +### 何时使用 + +当一组选项由2-3个层级构成,且每个层级有大量的选项需要用户逐级选择时使用。 + + +### 推荐/慎用示例 + +##### 级联选择器的层级不宜超过3层,层级过多时应调整数据结构或改用级联选择器。 + +
+
+ + +
+
+ + + +### 相似组件 + +| 组件名 | 何时使用 | +| :----- | :----------------------------------- | +| [选择器](./picker) | 当需要在有限的空间展示大量选项供用户选择时,或一组选项由递进层级构成,需要用户逐级选择使用时。| +| [级联选择器](./cascader) |当一组选项由递进层级构成,且有每个层级有大量的选项需要用户逐级选择使用时。| diff --git a/docs/miniprogram/_design/Upload.md b/docs/miniprogram/_design/Upload.md index 8711cdd371..58789bdb3a 100644 --- a/docs/miniprogram/_design/Upload.md +++ b/docs/miniprogram/_design/Upload.md @@ -43,5 +43,3 @@ - - diff --git a/docs/miniprogram/_design/avatar.md b/docs/miniprogram/_design/avatar.md index 8bae0abe39..f2760c576a 100644 --- a/docs/miniprogram/_design/avatar.md +++ b/docs/miniprogram/_design/avatar.md @@ -61,6 +61,3 @@ - - - diff --git a/docs/miniprogram/_design/swiper.md b/docs/miniprogram/_design/swiper.md index 069051b953..3a184535f1 100644 --- a/docs/miniprogram/_design/swiper.md +++ b/docs/miniprogram/_design/swiper.md @@ -40,4 +40,3 @@ - diff --git a/docs/miniprogram/design/avatar.md b/docs/miniprogram/design/avatar.md index 86b5d47d5e..eb7220cc4b 100644 --- a/docs/miniprogram/design/avatar.md +++ b/docs/miniprogram/design/avatar.md @@ -59,6 +59,3 @@ - - - diff --git a/docs/miniprogram/design/cell.md b/docs/miniprogram/design/cell.md new file mode 100644 index 0000000000..965f2bd0a5 --- /dev/null +++ b/docs/miniprogram/design/cell.md @@ -0,0 +1,55 @@ + + +### 常见用法 + +##### 常用作内容详情入口或功能入口的平铺陈列。 + +
+
+ +
+ +
+ +
+
+ +
+ +##### 常用作同类型同格式信息项平铺陈列。 + +
+
+ +
+
+ +### 推荐/慎用示例 + +##### 作为入口时,不建议承载过多过复杂的内容。 + +
+
+ + +
+
+ +
+ +##### 作为入口时,不建议在一个单元格内承载其他操作。 + +
+
+ + +
+
+ + + +### 相似组件 + +| 组件名 | 何时使用 | +| :----- | :----------------------------------- | +| [宫格](./grid) | 当需要展示多个功能或信息入口,且这些入口没有明显的优先级时使用。| diff --git a/docs/miniprogram/design/collapse.md b/docs/miniprogram/design/collapse.md new file mode 100644 index 0000000000..5ad03d869a --- /dev/null +++ b/docs/miniprogram/design/collapse.md @@ -0,0 +1,63 @@ + + +### 何时使用 + +当信息较多,需要进行收纳时使用。 + +### 常见用法 + +##### 经常用于信息种类较多的页面,将相对次要的信息收纳起来,让用户能够关注到页面中的主要信息或流程。 + +
+ +
+ +
+ +##### 在展示多条内容较长的同类型信息时,通常从中抽取出关键信息作为标题,收纳在手风琴式折叠面板中,便于用户检索和查看。 + +
+
+ +
+
+ +
+ +##### 在网站中,经常使用折叠面板作为分类导航,将页面进行归类、收纳在折叠面板中,展开后可点击跳转。 + +
+ +
+ + + +### 推荐/慎用示例 + +##### 当信息层级较多时,不建议嵌套折叠面板,层级过多时建议审视信息结构或使用其它交互方式展示。 + +
+
+ + +
+
+ +
+ +##### 不建议使用右箭头作为折叠面板的展开图标,用户可能会误把它认作跳转二级页面的入口。 + +
+
+ + +
+
+ + + +### 相似组件 + +| 组件名 | 何时使用 | +| :----- | :----------------------------------- | +| [下拉菜单](./dropdown-menu) |当内容较多时,需要通过筛选快速定位某一类内容时使用。| diff --git a/docs/miniprogram/design/dropdown-menu.md b/docs/miniprogram/design/dropdown-menu.md new file mode 100644 index 0000000000..12874dd344 --- /dev/null +++ b/docs/miniprogram/design/dropdown-menu.md @@ -0,0 +1,48 @@ + + +### 何时使用 + +当内容较多时,需要通过筛选快速定位某一类内容时使用。 + +### 常见用法 + +##### 常用于单个维度筛选或多个维度复合筛选的场景,可进行单选或多选。 + +
+
+ +
+ +
+ +
+
+ + +### 推荐/慎用示例 + +##### 在单选的筛选场景内,建议将用户选择项替换标题显示于菜单面板内。 + +
+
+ + +
+
+ +
+ +##### 当筛选维度为多选时,建议提供重置按钮,便于用户恢复到未筛选状态。 + +
+ + +
+ + + +### 相似组件 + +| 组件名 | 何时使用 | +| :----- | :----------------------------------- | +| [选择器](./Cascader) | 当需要在有限的空间展示大量选项供用户选择时,或一组选项由递进层级构成,需要用户逐级选择使用时。| diff --git a/docs/miniprogram/design/footer.md b/docs/miniprogram/design/footer.md new file mode 100644 index 0000000000..0aae241a4b --- /dev/null +++ b/docs/miniprogram/design/footer.md @@ -0,0 +1,61 @@ + + +### 何时使用 + +当页面底部需要放置一些补充信息和链接时使用。 + +### 与页面布局相关 + +##### 页脚通常位于网站每个页面底部或主体内容下方的区域。 + +
+
+ +
+
+ +### 常见用法 + +##### 用于承载版权、隐私政策和使用条款等信息,它们是法律保护所需的。 + +
+
+ +
+
+ +
+ +##### 用于承载网站、产品的联系方式,便于用户在页脚查找联系信息或查找获得客户支持的方式。 + +
+
+ +
+
+ +
+ +##### 用于承载网站导航。 + +
+
+ +
+
+ +
+ +##### 用于承载相关公司/品牌列表,让用户能认知合作或者旗下的品牌/公司,并提供找到他们的方式。 + +
+
+ +
+ +
+ +
+
+ + diff --git a/docs/miniprogram/design/grid.md b/docs/miniprogram/design/grid.md new file mode 100644 index 0000000000..4e019d23b5 --- /dev/null +++ b/docs/miniprogram/design/grid.md @@ -0,0 +1,88 @@ + + +### 何时使用 + +当需要展示多个功能或信息入口,且这些入口没有明显的优先级时使用。 + +### 组件搭配使用 + +##### 可与徽标组合使用,可作为消息提示、或其它相关的数量提示。 + +
+
+ +
+
+ +### 常见用法 + +##### 通常用于金刚区、或底部标签栏等,在页面中较为醒目的位置承载主要的功能入口。 + +
+
+ +
+
+ +
+ +##### 通常承载图片、头像等信息进行展示,并作为查看相应信息的入口。 + +
+
+ +
+ +
+ +
+
+ +
+ +##### 通常用于动作面板,和头像、图标按钮相结合,承载分享、保存到本地等操作。 + +
+
+ +
+
+ + +### 推荐/慎用示例 + +##### 当在金刚区使用宫格承载功能入口时,建议梳理功能的优先级,将金刚区控制在3行以内,一些相对次要的功能可通过左右滑动的方式收纳在第二屏。 + +
+
+ + +
+ +
+ + +
+
+ +
+ +
+
+ + +
+ +
+ + +
+
+ + + +### 相似组件 + +| 组件名 | 何时使用 | +| :----- | :----------------------------------- | +| [单元格](./cell) |用于各个类别行的信息展示。| diff --git a/docs/miniprogram/design/popup.md b/docs/miniprogram/design/popup.md new file mode 100644 index 0000000000..2fd21868f9 --- /dev/null +++ b/docs/miniprogram/design/popup.md @@ -0,0 +1,53 @@ + + +### 常见用法 + +##### 在筛选的场景,若筛选条件外露,通常会使用顶部弹出的弹出层;若为筛选入口,则通常触发使用右侧弹出的弹出层。 + +
+ +
+ +
+ +
+ +
+ +
+ +##### 承载页面中某个任务操作流程,通常会使用底部弹出的弹出层。 + +
+ +
+ +
+ +##### 承载重要提示且可能需要用户做出一些重要决策时,通常会使用中间弹出的弹出层。 + +
+
+ +
+
+ +
+ +##### 承载较为重要的运营活动入口(如拍脸图)时,通常会使用中间弹出的弹出层。 + +
+
+ +
+
+ +
+ +##### 承载网站、应用收折起来的导航菜单时,通常会使用左侧弹出的弹出层。 + +
+
+ +
+
diff --git a/docs/miniprogram/design/result.md b/docs/miniprogram/design/result.md index a55f5e2d8c..20a43b4678 100644 --- a/docs/miniprogram/design/result.md +++ b/docs/miniprogram/design/result.md @@ -52,4 +52,3 @@ | 组件名 | 何时使用 | | :----------------- | :--------------------------- | | [空状态](./empty ) | 当页面或模块数据为空时使用。 | - diff --git a/docs/miniprogram/design/swiper.md b/docs/miniprogram/design/swiper.md index 9a276c6493..17a00ac8f4 100644 --- a/docs/miniprogram/design/swiper.md +++ b/docs/miniprogram/design/swiper.md @@ -38,4 +38,3 @@ - diff --git a/docs/miniprogram/design/tag.md b/docs/miniprogram/design/tag.md new file mode 100644 index 0000000000..316091d4c8 --- /dev/null +++ b/docs/miniprogram/design/tag.md @@ -0,0 +1,86 @@ + + +### 何时使用 + +当需要展示内容本身的属性、状态、类别、营销情况时作为纯展示使用;或者当大量的内容数据需要根据类型进行选择筛选时使用。 + +### 组件搭配使用 + +##### 与[图片](./image)组合使用,图片作为内容、商品等对象的详情入口时,可通过添加标签来展示该对象的属性、状态、类别、营销情况等。 + +
+
+ +
+ +
+ +
+
+ +
+ +##### 与[下拉菜单](./dropdown-menu)组合使用,作为菜单面板下拉后的选项,供用户进行选择。 + +
+
+ +
+
+ +### 常见用法 + +##### 常用于展示对象本身的属性、状态、类别、营销情况等信息,且仅作为展示使用。 + +
+
+ +
+ +
+ +
+
+ +
+ +##### 常用于内容数据基于某个维度或某些维度的检索、筛选。 + +
+
+ +
+ +
+ +
+
+ + +### 推荐/慎用示例 + +##### 标签颜色和字体颜色在明度、色相上要避免难以区分,保证标签的可读性。 + +
+
+ + +
+
+ +
+ +##### 标签文案需要经过概括和提炼,不建议过长。 + +
+ + +
+ + + +### 相似组件 + +| 组件名 | 何时使用 | +| :----- | :----------------------------------- | +| [徽标](./badge) | 当需要展示特定对象的状态变化或承载运营性质提示时使用。| diff --git a/docs/miniprogram/design/tree-select.md b/docs/miniprogram/design/tree-select.md new file mode 100644 index 0000000000..b6229eaa51 --- /dev/null +++ b/docs/miniprogram/design/tree-select.md @@ -0,0 +1,26 @@ + + +### 何时使用 + +当一组选项由2-3个层级构成,且每个层级有大量的选项需要用户逐级选择时使用。 + + +### 推荐/慎用示例 + +##### 级联选择器的层级不宜超过3层,层级过多时应调整数据结构或改用级联选择器。 + +
+
+ + +
+
+ + + +### 相似组件 + +| 组件名 | 何时使用 | +| :----- | :----------------------------------- | +| [选择器](./picker) | 当需要在有限的空间展示大量选项供用户选择时,或一组选项由递进层级构成,需要用户逐级选择使用时。| +| [级联选择器](./cascader) |当一组选项由递进层级构成,且有每个层级有大量的选项需要用户逐级选择使用时。| diff --git a/docs/miniprogram/design/upload.md b/docs/miniprogram/design/upload.md index d8f14abb2c..5ce2473d2b 100644 --- a/docs/miniprogram/design/upload.md +++ b/docs/miniprogram/design/upload.md @@ -41,5 +41,3 @@ - -