文章目录
- 一、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的官方找到对应的组件示例:如下图所示:
代码依然复制,根据需求删除或者新增一些代码。
打开浏览器,查看页面效果: