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

elementui如何

2026-01-14 20:24:14前端教程

ElementUI 基本使用

ElementUI 是一套基于 Vue.js 的桌面端组件库，提供丰富的 UI 组件和交互功能。以下是 ElementUI 的基本使用方法。

安装 ElementUI

使用 npm 或 yarn 安装 ElementUI：

npm install element-ui --save

或

yarn add element-ui

引入 ElementUI

在项目中引入 ElementUI，可以选择完整引入或按需引入。

完整引入

在项目的入口文件（如 main.js）中添加以下代码：

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

Vue.use(ElementUI);

new Vue({
  el: '#app',
  render: h => h(App)
});

按需引入

借助 babel-plugin-component，可以只引入需要的组件，减小项目体积。

安装 babel-plugin-component：

npm install babel-plugin-component -D

修改 .babelrc 或 babel.config.js：

{
  "plugins": [
    [
      "component",
      {
        "libraryName": "element-ui",
        "styleLibraryName": "theme-chalk"
      }
    ]
  ]
}

然后在项目中按需引入组件：

import Vue from 'vue';
import { Button, Select } from 'element-ui';
import App from './App.vue';

Vue.use(Button);
Vue.use(Select);

new Vue({
  el: '#app',
  render: h => h(App)
});

使用 ElementUI 组件

在 Vue 单文件组件中直接使用 ElementUI 提供的组件。例如，使用按钮组件：

<template>
  <el-button type="primary">主要按钮</el-button>
</template>

主题定制

ElementUI 支持通过覆盖主题变量或使用在线主题生成工具定制主题。

覆盖主题变量

在项目中新建一个 SCSS 文件（如 element-variables.scss），覆盖默认变量：

$--color-primary: #409EFF;

@import "~element-ui/packages/theme-chalk/src/index";

然后在入口文件中引入该文件：

import './element-variables.scss';

在线主题生成

访问 ElementUI 主题生成器，在线定制主题并下载，将生成的 CSS 文件引入项目。

国际化支持

ElementUI 默认支持中文和英文，可以通过以下方式切换语言：

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

Vue.use(ElementUI, { locale });

常见问题

表单验证

ElementUI 提供表单验证功能，需要在表单组件上设置 rules 属性，并为表单项设置 prop 属性：

<template>
  <el-form :model="form" :rules="rules" ref="form">
    <el-form-item label="用户名" prop="name">
      <el-input v-model="form.name"></el-input>
    </el-form-item>
    <el-form-item>
      <el-button type="primary" @click="submitForm('form')">提交</el-button>
    </el-form-item>
  </el-form>
</template>

<script>
export default {
  data() {
    return {
      form: {
        name: ''
      },
      rules: {
        name: [
          { required: true, message: '请输入用户名', trigger: 'blur' }
        ]
      }
    };
  },
  methods: {
    submitForm(formName) {
      this.$refs[formName].validate((valid) => {
        if (valid) {
          alert('提交成功');
        }
      });
    }
  }
};
</script>

表格组件

ElementUI 的表格组件支持分页、排序、筛选等功能：

<template>
  <el-table :data="tableData" style="width: 100%">
    <el-table-column prop="date" label="日期" width="180"></el-table-column>
    <el-table-column prop="name" label="姓名" width="180"></el-table-column>
    <el-table-column prop="address" label="地址"></el-table-column>
  </el-table>
</template>

<script>
export default {
  data() {
    return {
      tableData: [
        {
          date: '2016-05-02',
          name: '王小虎',
          address: '上海市普陀区金沙江路 1518 弄'
        },
        {
          date: '2016-05-04',
          name: '王小虎',
          address: '上海市普陀区金沙江路 1517 弄'
        }
      ]
    };
  }
};
</script>