chore: update document for layout 🐶
@ -2,6 +2,9 @@ module.exports = {
|
||||
title: 'Vue Antd Admin',
|
||||
description: 'Vue Antd Admin',
|
||||
base: '/vue-antd-admin/',
|
||||
head: [
|
||||
['link', { rel: 'icon', href: '/favicon.ico' }]
|
||||
],
|
||||
themeConfig: {
|
||||
logo: '/logo.png',
|
||||
repo: 'iczer/vue-antd-admin',
|
||||
@ -25,7 +28,7 @@ module.exports = {
|
||||
title: '开发',
|
||||
collapsable: false,
|
||||
children: [
|
||||
'/develop/block', '/develop/layout', '/develop/router', '/develop/page', '/develop/theme', '/develop/service', '/develop/mock'
|
||||
'/develop/layout', '/develop/router', '/develop/page', '/develop/theme', '/develop/service', '/develop/mock'
|
||||
]
|
||||
},
|
||||
{
|
||||
|
BIN
docs/.vuepress/public/admin-layout.png
Normal file
After Width: | Height: | Size: 35 KiB |
BIN
docs/.vuepress/public/blank-view.png
Normal file
After Width: | Height: | Size: 46 KiB |
BIN
docs/.vuepress/public/common-layout.png
Normal file
After Width: | Height: | Size: 44 KiB |
BIN
docs/.vuepress/public/favicon.ico
Normal file
After Width: | Height: | Size: 2.8 KiB |
BIN
docs/.vuepress/public/page-layout.png
Normal file
After Width: | Height: | Size: 15 KiB |
BIN
docs/.vuepress/public/page-view.png
Normal file
After Width: | Height: | Size: 20 KiB |
BIN
docs/.vuepress/public/tabs-view.png
Normal file
After Width: | Height: | Size: 31 KiB |
@ -13,5 +13,5 @@ features:
|
||||
details: 享受 Vue + webpack 的开发体验,在 Markdown 中使用 Vue 组件,同时可以使用 Vue 来开发自定义主题。
|
||||
- title: 自然
|
||||
details: VuePress 为每个页面预渲染生成静态的 HTML,同时在页面被加载的时候,将作为 SPA 运行。
|
||||
footer: MIT Licensed | Copyright © 2018-present Evan You
|
||||
footer: MIT Licensed | Copyright © 2018-present iczer
|
||||
---
|
||||
|
@ -1,5 +0,0 @@
|
||||
---
|
||||
title: 区块
|
||||
lang: zh-CN
|
||||
---
|
||||
# 区块
|
@ -3,3 +3,77 @@ title: 布局
|
||||
lang: zh-CN
|
||||
---
|
||||
# 布局
|
||||
页面整体布局是一个产品最外层的框架结构,往往会包含导航、页脚、侧边栏、通知栏以及内容等。在页面之中,也有很多区块的布局结构。在真实项目中,页面布局通常统领整个应用的界面,有非常重要的作用。
|
||||
|
||||
## Vue Antd Admin 的布局
|
||||
在 Vue Antd Admin 中,我们抽离了使用过程中的通用布局,其中分为结构布局都放在 layouts 目录中,分别为:
|
||||
* [AdminLayout](https://github.com/iczer/vue-antd-admin/blob/master/src/layouts/AdminLayout.vue) / **管理后台布局**,包含了头部导航,侧边导航、内容区和页脚,一般用于后台系统的整体布局
|
||||
|
||||

|
||||
* [PageLayout](https://github.com/iczer/vue-antd-admin/blob/master/src/layouts/PageLayout.vue) / **页面布局**,包含了页头和内容区,常用于需要页头(一般包含面包屑、标题、额外操作等)的页面
|
||||
|
||||

|
||||
* [CommonLayout](https://github.com/iczer/vue-antd-admin/blob/master/src/layouts/CommonLayout.vue) / **通用布局**,仅包含页脚的简单布局,项目中常用于注册、登录或展示页面
|
||||
|
||||

|
||||
## Vue Antd Admin 的视图
|
||||
在 Vue Antd Admin 中,除了基本布局外,通常有很多页面的结构是相似的。因此,我们把这部分结构抽离为视图组件。
|
||||
一个视图组件通常包含一个基本布局组件、视图公共区块、路由视图内容区、页脚等,常常结合路由配置使用。它们也被放入了 layouts 目录中,分别为:
|
||||
* [TabsView](https://github.com/iczer/vue-antd-admin/blob/master/src/layouts/TabsView.vue) / **多页签视图**,包含了 AdminLayout 布局、多页签头和路由视图内容区
|
||||
|
||||

|
||||
* [PageView](https://github.com/iczer/vue-antd-admin/blob/master/src/layouts/PageView.vue) / **页面视图**,包含了 PageLayout 布局和路由视图内容区
|
||||
|
||||

|
||||
* [BlankView](https://github.com/iczer/vue-antd-admin/blob/master/src/layouts/BlankView.vue) / **空白视图**,仅包含一个路由视图内容区
|
||||
|
||||

|
||||
## 如何使用
|
||||
通常我们会把视图组件和路由配置结合一起使用,我们把配置信息抽离在路由配置文件中 [router/index.js](https://github.com/iczer/vue-antd-admin/blob/master/src/router/index.js) 。如下:
|
||||
```jsx
|
||||
{
|
||||
path: 'form',
|
||||
name: '表单页',
|
||||
meta: {
|
||||
icon: 'form',
|
||||
},
|
||||
component: PageView,
|
||||
children: [
|
||||
{
|
||||
path: 'basic',
|
||||
name: '基础表单',
|
||||
component: () => import('@/pages/form/basic/BasicForm'),
|
||||
}
|
||||
]
|
||||
}
|
||||
```
|
||||
当然,如果这满足不了你的需求,你也可以自定义一些视图组件,或者直接在页面组件中使用布局。参考
|
||||
[workplace](https://github.com/iczer/vue-antd-admin/blob/master/src/pages/dashboard/workplace/WorkPlace.vue) 页面:
|
||||
```vue
|
||||
<template>
|
||||
<page-layout :avatar="currUser.avatar">
|
||||
<div slot="headerContent">
|
||||
<div class="title">{{$t('timeFix')}},{{currUser.name}},{{$t('welcome')}}</div>
|
||||
<div>{{$t('position')}}</div>
|
||||
</div>
|
||||
<template slot="extra">
|
||||
<head-info class="split-right" :title="$t('project')" content="56"/>
|
||||
<head-info class="split-right" :title="$t('ranking')" content="8/24"/>
|
||||
<head-info class="split-right" :title="$t('visit')" content="2,223"/>
|
||||
</template>
|
||||
<div>...</div>
|
||||
</page-layout>
|
||||
</template>
|
||||
```
|
||||
## Ant Design Vue 布局组件
|
||||
除了 Admin 里的内建布局以外,在一些页面中需要进行布局,还可以使用 Ant Design Vue 提供的布局组件:Grid 和 Layout。
|
||||
### Grid 组件
|
||||
栅格布局是网页中最常用的布局,其特点就是按照一定比例划分页面,能够随着屏幕的变化依旧保持比例,从而具有弹性布局的特点。
|
||||
|
||||
而 Ant Design Vue 的栅格组件提供的功能更为强大,能够设置间距、具有支持响应式的比例设置,以及支持 flex 模式,基本上涵盖了大部分的布局场景,详情查看:[Grid](https://www.antdv.com/components/grid-cn/)。
|
||||
### Layout 组件
|
||||
如果你需要辅助页面框架级别的布局设计,那么 Layout 则是你最佳的选择,它抽象了大部分框架布局结构,使得只需要填空就可以开发规范专业的页面整体布局,详情查看:[Layout](https://www.antdv.com/components/layout-cn/)。
|
||||
### 根据不同场景区分抽离布局组件
|
||||
在大部分场景下,我们需要基于上面两个组件封装一些适用于当下具体业务的组件,包含了通用的导航、侧边栏、顶部通知、页面标题等元素。例如 Vue Antd Admin 的 AdminLayout。
|
||||
|
||||
通常,我们会把抽象出来的布局组件,放到 layouts 文件夹中方便管理。需要注意的是,这些布局组件和我们平时使用的其它组件并没有什么不同,只不过功能性上是为了处理布局问题而单独归类。
|
||||
|
@ -7,7 +7,7 @@ lang: zh-CN
|
||||
[Ant Design Pro Vue](https://github.com/vueComponent/ant-design-vue-pro) 是 [Ant Design Pro](https://github.com/ant-design/ant-design-pro) 的 Vue 版本,其中项目结构、组件、
|
||||
布局和使用方法等基本与 Ant Design Pro 的 react 版本保持一致。如果你比较熟悉 react 版,或者你已经在使用它,这确实是一个不错的选择。
|
||||
|
||||
[Vue Antd Admin](https://github.com/iczer/vue-antd-admin) 同样实现了 Ant Design Pro 的所有功能。但与此同时,我们还根据 Vue 的特性,对 Ant Design Pro 的一些组件和布局作出了相应的修改及优化,同时并不影响保持与 Ant Design Pro 的一致性。
|
||||
[Vue Antd Admin](https://github.com/iczer/vue-antd-admin) 同样实现了 Ant Design Pro 的所有功能。与此同时,我们还根据 Vue 的特性,对 Ant Design Pro 的一些组件和布局作出了相应的修改及优化,同时不影响保持与 Ant Design Pro 的一致。
|
||||
|
||||
另外,我们还在添加一些 Ant Design Pro 没有的功能,比如全局动画、多页签模式等。
|
||||
|
||||
|