ElementPlus的简单使用

---

一、ElementPlus介绍

Element：是饿了么公司前端开发团队提供的一套基于 Vue3 的网站组件库，用于快速构建网页。

Element 提供了很多组件（组成网页的部件）供我们使用。例如 超链接、按钮、图片、表格等等。

官方网站：https://element-plus.org/zh-CN/#/zh-CN
链接: link

二、快速入门

准备工作

1、需要创建一个vue项目。
2、 参照官方文档，安装ElementPlus的组件库（在当前工程的目录下）
在控制台输入这段命令

npm install element-plus --save

3、在main.ts 中引入ElementPlus组件库 （参照官方文档），最终 main.ts 中代码如下：

import { createApp } from 'vue'
import App from './App.vue'
import './assets/main.css'
import ElementPlus from 'element-plus'
import 'element-plus/dist/index.css'

const app = createApp(App)

app.use(ElementPlus)
app.mount('#app')

制作组件

1、访问ElementPlus的官方文档，查看对应的组件源代码。

2、在 views 目录下，创建Element.vue组件文件，复制组件代码，调整成自己想要的 。

<script setup lang="ts">

</script>

<template>
  <el-row class="mb-4">
    <el-button>Default</el-button>
    <el-button type="primary">Primary</el-button>
    <el-button type="success">Success</el-button>
    <el-button type="info">Info</el-button>
    <el-button type="warning">Warning</el-button>
    <el-button type="danger">Danger</el-button>
  </el-row>
</template>

<style scoped>

</style>

3、 启动项目

三、常见组件

表格组件

用于展示多条结构类似的数据， 可对数据进行排序、筛选、对比或其他自定义操作。
首先我们需要来到 ElementPlus 的组件库中，找到表格组件，如下图所示：

然后新建一个组件 Element.vue，组件中，需要注意的是，我们组件包括了3个部分，如果官方有除了template部分之外的style和script都需要复制。具体操作如下图所示：

此时回到浏览器，我们页面呈现如下效果：

Table表格组件，属性说明：

• data: 主要定义table组件的数据模型
• prop: 定义列的数据应该绑定data中定义的具体的数据模型
• label: 定义列的标题
• width: 定义列的宽度

分页条组件

Pagination: 分页组件，主要提供分页工具条相关功能。其展示效果图下图所示：

默认情况下，ElementPlus的组件是英文的，如果希望使用中文语言，可以在 main.ts 中做如下配置：

import zhCn from 'element-plus/dist/locale/zh-cn.mjs'
app.use(ElementPlus, {locale: zhCn})

如图所示：

然后还需要在 env.d.ts 中增加如下配置项：

declare module 'element-plus/dist/locale/zh-cn.mjs'

如图所示：

两个文件在这里

然后复制代码到我们的 Element.vue 组件文件的template中，在 <template> </template> 拷贝如下代码：

在 <script> </script> 中拷贝如下代码：

注意：有些代码是没有用到的，所以可以删去。

打开浏览器，查看页面效果如下：

Pagination 分页组件的属性如下：
对于分页组件我们需要关注的是如下几个重要属性（可以通过查阅官网组件中最下面的组件属性详细说明得到）：

• background: 添加背景颜色，也就是上图蓝色背景色效果。
• layout: 分页工具条的布局，其具体值包含sizes, prev, pager, next, jumper, total 这些值
• total: 数据的总数量

对于分页组件，除了上述几个属性，还有2个非常重要的事件我们需要去学习：

• size-change ： pageSize 改变时会触发
• current-change ：currentPage 改变时会触发

对话框组件

在保留当前页面状态的情况下，告知用户并承载相关操作。
首先我们需要在ElementPlus官方找到Dialog组件，如下图所示：

然后复制如下代码到我们的组件文件 Element.vue 的 <template></template> 模块中：

然后复制如下代码到我们的组件文件 Element.vue 的 <script></script> 模块中：

打开浏览器，最终的页面效果如下：

表单组件

Form 表单：由输入框、选择器、单选框、多选框等控件组成，用以收集、校验、提交数据。

表单在我们前端的开发中使用的还是比较多的，接下来我们学习这个组件，与之前的流程一样，我们首先需要在ElementPlus的官方找到对应的组件示例：如下图所示：

代码依然复制，根据需求删除或者新增一些代码。

打开浏览器，查看页面效果：