【JavaWeb学习Day25】

Web前端实战

ElementPlus

什么是ElementPlus

ElementPlus：是饿了么团队研发的，基于Vue3，面向设计师和开发者的组件库。

组件：组成网页的部件，例如超链接、按钮、图片、表格、表单、分页条等等。

官网：一个 Vue 3 UI 框架 | Element Plus

快速入门

准备工作：

1.创建vue项目

2.参照官方文档，安装Element Plus组件库（在当前工程的目录下）：npm install element-plus@2.2.4 --save

3.main.js中引入Element Plus组件库（参照官方文档）

import { createApp } from 'vue'
//引入element
import ElementPlus from 'element-plus'
import 'element-plus/dist/index.css'
import App from './App.vue'
​
​
createApp(App).use(ElementPlus).mount('#app')

​

制作组件：访问Element官方文档，复制组件代码，调整。

常见组件

表格组件：

用于展示多条结构类似的数据，可对数据进行排序、筛选、对比或其他自定义操作。

<script setup>
const tableData = [
  {
    date: '2016-05-03',
    name: 'Tom',
    address: 'No. 189, Grove St, Los Angeles',
  },
  {
    date: '2016-05-02',
    name: 'Tom',
    address: 'No. 189, Grove St, Los Angeles',
  },
  {
    date: '2016-05-04',
    name: 'Tom',
    address: 'No. 189, Grove St, Los Angeles',
  },
  {
    date: '2016-05-01',
    name: 'Tom',
    address: 'No. 189, Grove St, Los Angeles',
  },
]
</script>
​
<template>  
<div class="mb-4">
  <el-table :data="tableData" border style="width: 100%">
    <el-table-column prop="date" label="Date" width="180" />
    <el-table-column prop="name" label="Name" width="180" />
    <el-table-column prop="address" label="Address" />
  </el-table>
  </div>
</template>

表格组件使用的关键点在于清楚表格中绑定的数据data，以及每一列要展示的属性信息。项目开发中的数据应该是Ajax异步请求服务端，服务端返回。

分页条组件：

当数据量过多时，使用分页操作分解数据。

默认Element Plus的组件是英文的，如果希望使用中文语言，可以做如下配置：

import zhCn from 'element-plus/es/locale/lang/zh-cn'
createApp(App).use(ElementPlus,{locale:zhCn}).mount('#app')
<script setup>
import { ref } from 'vue';// 导入 ref 函数
const currentPage4 = ref(1);// 定义当前页码
const size = ref('default');// 定义分页大小
const background = ref(true);// 定义是否显示背景  
</script>
<template>  
<div>
    <el-pagination
      v-model:current-page="currentPage4"
      v-model:page-size="pageSize4"
      :page-sizes="[100, 200, 300, 400]"
      :disabled="disabled"
      :background="background"
      layout="total, sizes, prev, pager, next, jumper"
      :total="400"
      @size-change="handleSizeChange"
      @current-change="handleCurrentChange"
    />
  </div>
</template>

对话框组件：

在保留当前页面状态的情况下，告知用户并承载相关操作。

通过model-value/v-model给定的boolean值，来控制Dialog的显示和隐藏。

<script setup>
const dialogTableVisible = ref(false);// 定义对话框是否可见
</script>
<template>  
  <div class="mb-4">
    <el-button plain @click="dialogTableVisible = true">
    Open a Table nested Dialog
  </el-button>
  <el-dialog v-model="dialogTableVisible" title="Shipping address" width="800">
    <el-table :data="tableData">
      <el-table-column property="date" label="Date" width="150" />
      <el-table-column property="name" label="Name" width="200" />
      <el-table-column property="address" label="Address" />
    </el-table>
  </el-dialog>
  </div>
</template>

表单组件：

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

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

表单项数据采集：v-model数据绑定

表单数据提交：事件绑定

<!-- Form 表单 -->
  <el-form :inline="true" :model="formInline" class="demo-form-inline">
    <el-form-item label="Approved by">
      <el-input v-model="formInline.user" placeholder="Approved by" clearable />
    </el-form-item>
​
    <el-form-item label="Activity zone">
      <el-select v-model="formInline.region" placeholder="Activity zone" clearable>
        <el-option label="Zone one" value="shanghai" />
        <el-option label="Zone two" value="beijing" />
      </el-select>
    </el-form-item>
​
    <el-form-item label="Activity time">
      <el-date-picker v-model="formInline.date" type="date" placeholder="Pick a date" clearable/>
    </el-form-item>
    
    <el-form-item>
      <el-button type="primary" @click="onSubmit">Query</el-button>
    </el-form-item>
  </el-form>

案例

需求：基于ElementPlus组件库制作如下页面，并异步获取数据，完成页面展示。

1). 准备工作

由于在案例中，我们需要在vue项目中使用Axios，需要安装axios，需要在当前项目的目录下执行如下命令：

npm install axios

2). 编码实现

在views目录下，再定义一个文件 EmpList.vue，具体代码实现如下：

<script setup>
import { ref, onMounted } from 'vue'
import axios from 'axios'
​
const searchEmp = ref({
  name: '',
  gender: '',
  job: '',
})
​
onMounted(() => {
  search();
})
​
const search = async () => {
  const url = `https://web-server.itheima.net/emps/list?name=${searchEmp.value.name}&gender=${searchEmp.value.gender}&job=${searchEmp.value.job}`
  const result = await axios.get(url)
  tableData.value = result.data.data
}
​
const clear = () => {
  searchEmp.value = { name: '', gender: '', job: '' }
  search();
}
​
let tableData = ref([])
</script>
​
<template>
  <div id="center">
    <el-form :inline="true" :model="searchEmp" class="demo-form-inline">
      <el-form-item label="姓名">
        <el-input v-model="searchEmp.name" placeholder="请输入姓名" clearable />
      </el-form-item>
      <el-form-item label="性别">
        <el-select v-model="searchEmp.gender" placeholder="请选择" clearable>
          <el-option label="男" value="1" />
          <el-option label="女" value="2" />
        </el-select>
      </el-form-item>
      <el-form-item label="职位">
        <el-select v-model="searchEmp.job" placeholder="请选择" clearable>
          <el-option label="班主任" value="1" />
          <el-option label="讲师" value="2" />
          <el-option label="咨询师" value="3" />
        </el-select>
      </el-form-item>
      <el-form-item>
        <el-button type="primary" @click="search">查询</el-button>
        <el-button type="primary" @click="clear">清空</el-button>
      </el-form-item>
    </el-form>
    <br>
​
    <!-- 表格 -->
    <el-table :data="tableData" border style="width: 100%; ">
      <el-table-column prop="id" label="ID" width="80" align="center" />
      <el-table-column prop="name" label="姓名" width="100" align="center" />
      <el-table-column label="头像" width="120" align="center">
        <template #default="scope">
          <img :src="scope.row.image" width="50">
        </template>
      </el-table-column>
      <el-table-column prop="gender" label="性别" width="120" align="center">
        <template #default="scope">
          {{ scope.row.gender == 1 ? '男' : '女' }}
        </template>
      </el-table-column>
      <el-table-column label="职位" width="180" align="center">
        <template #default="scope">
          <span v-if="scope.row.job == 1">班主任</span>
          <span v-else-if="scope.row.job == 2">讲师</span>
          <span v-else-if="scope.row.job == 3">咨询师</span>
          <span v-else>其他</span>
        </template>
      </el-table-column>
      <el-table-column prop="entrydate" label="入职日期" width="180" align="center" />
      <el-table-column prop="updatetime" label="更新时间" align="center" />
    </el-table>
  </div>
</template>
​
<style scoped>
#center {
  width: 70%;
  margin: auto;
  margin-top: 100px;
}
</style>
在 App.vue 中引入 EmpList.vue 文件

<script setup>
  import EmpList from './views/EmpList.vue'
</script>
​
<template>
  <EmpList></EmpList>
</template>
​
<style scoped>
​
</style>

3). 打开浏览器，查看页面效果