- 安装 Element Plus
首先,我们需要安装 Element Plus 和它所依赖的 CSS 文件。在项目根目录下执行以下命令:
npm install element-plus
- 导入并注册 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
元素上。
- 使用 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
和 model
,label-width
设置了标签的宽度。在 el-form
内部,我们使用了 el-form-item
组件来包装表单控件。其中,el-input
组件用于输入框,el-select
组件用于选择框,el-date-picker
组件用于日期选择器,el-button
组件用于提交按钮。
在表单的 data
方法中,我们定义了表单数据对象 form
,并在 methods
中定义了 submitForm
方法用于处理表单的提交操作。
- 表单验证
Element Plus 的表单组件提供了灵活且全面的表单验证功能。在上述代码中,我们使用了 this.$refs.form.validate
方法来验证表单。在 submitForm
方法中,我们调用了 validate
方法,并传入一个回调函数,在回调函数中判断表单验证的结果。根据验证结果,我们可以继续处理提交逻辑或者中止提交操作。