当前位置：首页 > 前端教程

elementui指南

2026-01-14 22:14:56前端教程

以下是关于 Element UI 的指南内容整理，涵盖核心功能、使用方法和常见实践：

安装与引入

通过 npm 安装：

npm install element-ui -S

在项目中全局引入：

import Vue from 'vue';
import ElementUI from 'element-ui';
import 'element-ui/lib/theme-chalk/index.css';

Vue.use(ElementUI);

按需引入（推荐）：

import { Button, Select } from 'element-ui';
Vue.component(Button.name, Button);

基础组件使用

表单组件示例：

<el-form :model="formData" label-width="80px">
  <el-form-item label="用户名">
    <el-input v-model="formData.username"></el-input>
  </el-form-item>
  <el-form-item label="密码">
    <el-input type="password" v-model="formData.password"></el-input>
  </el-form-item>
</el-form>

表格组件示例：

elementui指南

<el-table :data="tableData">
  <el-table-column prop="date" label="日期"></el-table-column>
  <el-table-column prop="name" label="姓名"></el-table-column>
</el-table>

主题定制

通过 SCSS 变量覆盖修改主题色：

/* 在项目中创建 theme.scss */
$--color-primary: #FF6A00;
@import "~element-ui/packages/theme-chalk/src/index";

配置 webpack 加载自定义主题：

{
  loader: 'sass-loader',
  options: {
    prependData: `@import "@/assets/theme.scss";`
  }
}

国际化支持

设置中文语言包：

elementui指南

import Vue from 'vue';
import ElementUI from 'element-ui';
import locale from 'element-ui/lib/locale/lang/zh-CN';

Vue.use(ElementUI, { locale });

常见问题解决

表单验证触发时机：

<el-form :rules="rules" :model="form" ref="form">
  <el-form-item prop="email" :rules="[{ required: true, message: '请输入邮箱' }]">
    <el-input v-model="form.email"></el-input>
  </el-form-item>
</el-form>

手动触发验证：

this.$refs.form.validate((valid) => {
  if (valid) {
    // 提交逻辑
  }
});

最佳实践

复杂表格处理建议：

大数据量使用 <el-table> 的 lazy 属性
自定义列模板使用 scoped-slot
固定列和表头结合 fixed 属性

表单布局优化：

<el-form inline>
  <el-form-item label="搜索">
    <el-input placeholder="关键词"></el-input>
  </el-form-item>
  <el-form-item>
    <el-button type="primary">查询</el-button>
  </el-form-item>
</el-form>