ElementPlus的简单使用

文章目录

一、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> 模块中：

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