1. 安装 Element Plus

首先,我们需要安装 Element Plus 和它所依赖的 CSS 文件。在项目根目录下执行以下命令:

npm install element-plus
  1. 导入并注册 Element Plus 组件

在 Vue 3 的入口文件(一般是 main.js)中,我们需要导入 Element Plus 组件,并全局注册它们:

import { createApp } from 'vue'
import ElementPlus from 'element-plus'
import 'element-plus/lib/theme-chalk/index.css'

const app = createApp(App)
app.use(ElementPlus)
app.mount('#app')

在上述代码中,我们首先导入了 createApp 函数来创建 Vue 应用实例。然后,我们导入了 Element Plus 组件,并使用 app.use() 方法将它们注册到 Vue 应用中。最后,我们调用 app.mount('#app') 将 Vue 应用挂载到 HTML 页面中的 #app 元素上。

  1. 使用 Element Plus 组件

接下来,我们就可以在 Vue 组件中使用 Element Plus 的组件了。比如,我们可以在 App.vue 组件中使用一个简单的按钮组件:

<template>
  <el-button type="primary">Click me!</el-button>
</template>

在上述代码中,我们使用了 Element Plus 的按钮组件 <el-button>,并设置了 type 属性为 'primary',以展示一个主要按钮。你也可以根据自己的需求配置按钮的样式、大小以及其他属性

例如:在 Vue 组件中,创建一个包含表单的子组件。以一个包含输入框、选择框、日期选择器和提交按钮的表单为例:

<template>
  <el-form ref="form" :model="form" label-width="80px">
    <el-form-item label="姓名">
      <el-input v-model="form.name"></el-input>
    </el-form-item>
    <el-form-item label="性别">
      <el-select v-model="form.gender" placeholder="请选择">
        <el-option label="男" value="male"></el-option>
        <el-option label="女" value="female"></el-option>
      </el-select>
    </el-form-item>
    <el-form-item label="出生日期">
      <el-date-picker v-model="form.birthday" type="date" placeholder="选择日期"></el-date-picker>
    </el-form-item>
    <el-form-item>
      <el-button type="primary" @click="submitForm">提交</el-button>
    </el-form-item>
  </el-form>
</template>

<script>
export default {
  data() {
    return {
      form: {
        name: '',
        gender: '',
        birthday: ''
      }
    };
  },
  methods: {
    submitForm() {
      this.$refs.form.validate((valid) => {
        if (valid) {
          // 表单验证通过,可以提交
          console.log(this.form);
        } else {
          // 表单验证失败,做出相应处理
          return false;
        }
      });
    }
  }
};
</script>

在上述代码中,我们使用了 Element Plus 的表单组件。通过 el-form 组件创建了一个表单容器,并为其设置了参数 ref 和 modellabel-width 设置了标签的宽度。在 el-form 内部,我们使用了 el-form-item 组件来包装表单控件。其中,el-input 组件用于输入框,el-select 组件用于选择框,el-date-picker 组件用于日期选择器,el-button 组件用于提交按钮。

在表单的 data 方法中,我们定义了表单数据对象 form,并在 methods 中定义了 submitForm 方法用于处理表单的提交操作。

  1. 表单验证

Element Plus 的表单组件提供了灵活且全面的表单验证功能。在上述代码中,我们使用了 this.$refs.form.validate 方法来验证表单。在 submitForm 方法中,我们调用了 validate 方法,并传入一个回调函数,在回调函数中判断表单验证的结果。根据验证结果,我们可以继续处理提交逻辑或者中止提交操作。