Vue3 入门笔记三 ---- 利用Element Plus对页面进行布局划分以及实现左侧公共菜单

这个系列的笔记重点会放在怎么样利用Vue3把项目架设起来并跟后端API互动,不会介绍Vue的基础特性,关于Vue的基础特性可以参考这个视频四个小时带你快速入门Vue,我是看这个入门的,觉得还不错。

代码地址: https://github.com/yexia553/vue_study/tree/%E9%85%8D%E7%BD%AEvue-router/vue3-notes

页面布局说明以及效果展示

一个网站总有自己的布局的,所谓布局就是在什么区域展示什么信息,下面的图片就是我们设计的布局效果,分为三个部分。

页面的左侧是一个整体,用于展示菜单栏,也就是显示了网站有哪些模块;右侧分为上下两部分,上面是用于显示用户的头像,点击头像可以进行登出等操作;右侧的下半部分是网站的主体区域,展示我们希望像用户传递的信息。

由于左侧的菜单栏和右侧上半部分不论再那个页面都需要,所以我们就可以把这两个部分做成公共组件,可以为左侧菜单栏起个名字叫做CommonAside,右侧的上半部分叫做CommonHeader。

Element Plus简介

会Vue的人基本知道Element UI(和Vue2搭配使用)或者Element Plus, 他们的作用就是封装好了很多UI库,方便我们直接使用,比如我们想实现一个表格,就可以使用el-table 标签帮助我们实现。

实现布局

1. 安装

要使用Element Plus,首先要安装,在项目的根目录下执行下面的命令就可以了

1
npm install element-plus --save

由于我们后面还要使用Element Plus里面的icon,这里也一并安装

1
npm install @element-plus/icons-vue

2. 引入

安装好之后还要在Vue3中引入Element Plus才能在Vue3中使用,我们采用全局引入的方式,但是其实引入的方法有好几种,可以点击这里查看具体有哪些引入方法。

引入的方法是在main.js中进行配置,配置之后main.js如下所示,我在代码中备注了哪些代码是引入所需要的。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
import { createApp } from 'vue'
import App from './App.vue'
import ElementPlus from 'element-plus' // 引入Element Plus 所需
import 'element-plus/dist/index.css' // 引入Element Plus 所需
import router from './router/index.js'
import * as ElementPlusIconsVue from '@element-plus/icons-vue' // 引入Element Plus icon 所需
import './assets/main.css'

const app = createApp(App)

// 引入Element Plus icon 所需
for (const [key, component] of Object.entries(ElementPlusIconsVue)) {
    app.component(key, component)
}

app.use(router)
app.use(ElementPlus) // 引入Element Plus 所需
app.mount('#app')
```

#### 3. 修改Vue3初始样式
Vue3在创建项目的项目的时候默认有一些样式,也就是css,在 项目根目录/src/assets/路径下,有base.css 和main.css这两个样式文件,我们修改main.css就可以了。

主要是修改main.css 中两个 **#app** 部分,修改后如下:
```css
#app {
    /* max-width: 1280px; */
    margin: 0;
    padding: 0;
    font-weight: normal;
    height: 100vh;
    width: 100%;
}
1
2
3
4
5
    #app {
        /* display: grid; */
        /* grid-template-columns: 1fr 1fr; */
        padding: 0;
    }

css的部分不详细解释了,主要的目的就是为了vue能够正常在浏览器中显示我们的页面,看不懂的话需要去简单学一下css的部分。

实现布局

上一篇笔记讲路由的时候,我们在Main.vue中写入了

1
2
3
<template>
Home
</template>

我们现在将里面的内容替换为下面的部分

1
2
3
4
5
6
7
8
9
10
11
12
13
14

<template>
    <div class="common-layout">
        <el-container>
            <el-aside width="180px">
                Aside
            </el-aside>
            <el-container>
                <el-header>Header</el-header>
                <el-main>Main</el-main>
            </el-container>
        </el-container>
    </div>
</template>

替换之后,大家在项目根目录下执行 npm run dev 运行项目,应该可以看到如下的页面
vue页面布局简单效果

可以看到,虽然很简单,但是页面整体的框架已经出来了。

CommonAside组件

上面提到过,我们可以把左侧菜单栏抽成一个组件,称之为CommonAside。我们现在来实现它。

创建CommonAside.vue文件

首先先删除src/components在项目初始化的时候自动创建的内容。
在src/components路径下创建CommonAside.vue这个文件,文件内容如下,

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
<template>
    <el-menu class="el-menu-vertical-demo" background-color="#545c64" text-color="#fff" :collapse-transition="false"
        active-text-color="#ffd04b">
        <h3>后台管理</h3>
        <el-menu-item :index="item.path+''" v-for="item in list" :key="item.label">
            <component class="icons" :is="item.icon"></component>
            <span>{{item.label}}</span>
        </el-menu-item>
    </el-menu>
</template>


<script>
export default {
    setup() {
        const list = [
            {
                path: '/user',
                name: 'user',
                label: '用户管理',
                icon: 'user',
                url: '/user'
            },
            {
                label: '其它',
                name: 'other',
                icon: 'location',
                path: '/other',
                url: 'other'
            },
        ];
        return {
            list,
        }
    }
}
</script>

<style lang="less" scoped>
.icons {
    width: 18px;
    height: 18px;
    margin-right: 4px;
}
.el-menu-vertical-demo {
    width: 100%;
    border-right: none;
    h3 {
        color: #fff;
        text-align: center;
        margin-top: 10px;
    }
}
</style>

代码中分为template、script和style三个部分,我们分别来说明一下。

template

template里面引用el-menu标签实现我们需要的样式,我们这里其实只使用了很简单的部门,还有很多方法和属性我们都没有使用,大家可以多看看element plus的官网。

script

script里面是js代码,Vue3支持选项式API和组合式API,我使用的是组合式API,关于这两者的区别以及应该怎么选择可以看这里

我在script里面其实就定义并返回了一个包含左侧菜单内容的list。

style

style里面是样式,也就是css,但是我使用的是less,关于less的部分可以看这里, 其实不会less的也没关系,看看上面的代码,跟着模仿就行了,我其实也不会less,只会模仿而已。

使用CommonAside.vue 组件

之前分析过,CommonAside这个组件会在所有的页面中都出现,所以我们可以在Main.vue中引入这个组件,引入之后Main.vue的内容如下,

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
<template>
    <div class="common-layout">
        <el-container>
            <el-aside width="180px">
<!-- 要注意这里引用CommonAside组件的方法,拆分了两个字符,用中短线连接的-->
                <common-aside></common-aside>
            </el-aside>
            <el-container>
                <el-header>Header</el-header>
                <el-main>Main</el-main>
            </el-container>
        </el-container>
    </div>
</template>

<script>
import CommonAside from "../components/CommonAside.vue";
export default {
    components: {
        CommonAside,
    }
}
</script>

<style lang="less" scoped>
.common-layout {
    height: 100%;
    &>.el-container {
        height: 100%;
        &>.el-aside {
            height: 100%;
            background: #545c64;
        }
        &>.el-container {
            &>.el-header {
                padding: 0%;
            }
        }
    }
}
</style>

代码的内容很简单,只解释一下style里面的一个小知识点。

.common-layout 表示 其后所跟的花括号的样式会作用在class=”common-layout”的范围内,
我们会看到 .common-layout下面会有 &>.el-container,这会关联到common-layout里面的el-container,如果在.common-layout之外也有el-container的话是不会起效的。


到这里CommonAside组件也完成了,启动项目之后页面应该如下所示,
vue3 common aisde 效果