2021SC@SDUSC
文章目录
Element UI简介
ElementUI是一套为开发者、设计师和产品经理准备的基于 Vue 2.0 的桌面端组件库。是山东大学学生程序设计能力提升平台项目web前端部分所使用的主要UI组件库。
Element UI的安装
ElementUI的安装
ElementUI的安装主要有两种方式:
- npm安装
- CDN安装
npm安装
这里推荐使用npm的方式安装,因为它能更好地和webpack打包工具配合使用。
按下WIN
+R
组合键,呼出“运行”窗口,输入cmd
,按下回车打开命令提示符窗口。
首先输入npm -v
,查看npm版本号,若控制台打印了npm的版本号,则说明计算机已安装node.js。若系统提示npm不是内部或外部命令
,则说明系统并未安装npm,请参考之前的博客进行安装。
在cmd窗口中输入:
npm i element-ui -S
则全局安装elementUI。
当然也可以仅对该项目添加elementUI,方法如下:
前往项目文件夹根目录,运行终端,(因为本人更习惯使用yarn添加依赖,故此处仅给出yarn的命令作为示例),在终端中输入:
yarn add element-ui
即可仅对该项目添加elementUI组件库。
P.S.
推荐使用vscode内置的终端进行项目依赖管理,而不是cmd。
Windows
的cmd并非对标Linux
系统的终端。
微软官方宣布使用PowerShell作为自家系统的终端。
选用vscode的内置终端目的也在此:
一是为了方便,二是因为vscode的终端正是使用PowerShell而不是cmd。
但是,在vscode的终端使用npm等指令时,可能会出现报错
法将“npm”项识别为 cmdlet、函数、脚本文件或可运行程序的名称。请检查名称的拼写,如果包括路径,请确保路径正确,然后再试一次。 所在位置 行:1 字符: 1
这与Windows的执行策略有关,右键电脑左下角的开始按钮,点击Windows PowerShell (管理员)
输入:
set-ExecutionPolicy RemoteSigned
选择 A
此时便可在vscode的终端中正常使用npm指令了。
CDN安装
通过cdn安装则较为简单,但个人不推荐使用这种方式进行安装。以下是CDN的安装教程:
目前可以通过unpkg.com/element-ui获取到最新版本的资源,在页面上引入js和css文件即可开始使用。
引入方式如下:
<!-- 引入样式 -->
<link rel="stylesheet" href="https://unpkg.com/element-ui/lib/theme-chalk/index.css">
<!-- 引入组件库 -->
<script src="https://unpkg.com/element-ui/lib/index.js"></script>
ElementUI官方建议使用 CDN 引入 Element 的用户在链接地址上锁定版本,以免将来 Element 升级时受到非兼容性更新的影响。锁定版本的方法请查看unpkg.com
通过 CDN 的方式我们可以很容易地使用 Element UI
如果是通过 npm 安装,并希望配合 webpack 使用,请继续阅读本博客
Element UI 的配置
若是使用vue-cli@3,ElementUI官方提供了新的Element插件
使用 Starter Kit
ElementUI官方提供了通用的项目模板,可供直接使用。对于 Laravel 用户也准备了相应的模板,同样可以直接下载使用。
不过由于该项目使用 Vue2 搭建,因此还请继续阅读
引入ElementUI
我们可以引入整个 Element,或是根据需要仅引入部分组件。我们先介绍如何引入完整的 Element。
完整引入
在 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)
});
以上代码便完成了 Element 的引入。需要注意的是,样式文件需要单独引入。
这也是该项目所使用的引入方式
按需引入
借助 babel-plugin-component,我们可以只引入需要的组件,以达到减小项目体积的目的。
首先,安装babel-plugin-component:
npm install babel-plugin-component -D
然后,将.babelrc 修改为:
{
"presets": [["es2015", { "modules": false }]],
"plugins": [
[
"component",
{
"libraryName": "element-ui",
"styleLibraryName": "theme-chalk"
}
]
]
}
接下来,如果只希望引入部分组件,比如 Button 和 Select,那么需要在 main.js 中写入以下内容:
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)
});
完整组件列表和引入方式(完整组件列表以 components.json 为准):
import Vue from 'vue';
import {
Pagination,
Dialog,
Autocomplete,
Dropdown,
DropdownMenu,
DropdownItem,
Menu,
Submenu,
MenuItem,
MenuItemGroup,
Input,
InputNumber,
Radio,
RadioGroup,
RadioButton,
Checkbox,
CheckboxButton,
CheckboxGroup,
Switch,
Select,
Option,
OptionGroup,
Button,
ButtonGroup,
Table,
TableColumn,
DatePicker,
TimeSelect,
TimePicker,
Popover,
Tooltip,
Breadcrumb,
BreadcrumbItem,
Form,
FormItem,
Tabs,
TabPane,
Tag,
Tree,
Alert,
Slider,
Icon,
Row,
Col,
Upload,
Progress,
Spinner,
Badge,
Card,
Rate,
Steps,
Step,
Carousel,
CarouselItem,
Collapse,
CollapseItem,
Cascader,
ColorPicker,
Transfer,
Container,
Header,
Aside,
Main,
Footer,
Timeline,
TimelineItem,
Link,
Divider,
Image,
Calendar,
Backtop,
PageHeader,
CascaderPanel,
Loading,
MessageBox,
Message,
Notification
} from 'element-ui';
Vue.use(Pagination);
Vue.use(Dialog);
Vue.use(Autocomplete);
Vue.use(Dropdown);
Vue.use(DropdownMenu);
Vue.use(DropdownItem);
Vue.use(Menu);
Vue.use(Submenu);
Vue.use(MenuItem);
Vue.use(MenuItemGroup);
Vue.use(Input);
Vue.use(InputNumber);
Vue.use(Radio);
Vue.use(RadioGroup);
Vue.use(RadioButton);
Vue.use(Checkbox);
Vue.use(CheckboxButton);
Vue.use(CheckboxGroup);
Vue.use(Switch);
Vue.use(Select);
Vue.use(Option);
Vue.use(OptionGroup);
Vue.use(Button);
Vue.use(ButtonGroup);
Vue.use(Table);
Vue.use(TableColumn);
Vue.use(DatePicker);
Vue.use(TimeSelect);
Vue.use(TimePicker);
Vue.use(Popover);
Vue.use(Tooltip);
Vue.use(Breadcrumb);
Vue.use(BreadcrumbItem);
Vue.use(Form);
Vue.use(FormItem);
Vue.use(Tabs);
Vue.use(TabPane);
Vue.use(Tag);
Vue.use(Tree);
Vue.use(Alert);
Vue.use(Slider);
Vue.use(Icon);
Vue.use(Row);
Vue.use(Col);
Vue.use(Upload);
Vue.use(Progress);
Vue.use(Spinner);
Vue.use(Badge);
Vue.use(Card);
Vue.use(Rate);
Vue.use(Steps);
Vue.use(Step);
Vue.use(Carousel);
Vue.use(CarouselItem);
Vue.use(Collapse);
Vue.use(CollapseItem);
Vue.use(Cascader);
Vue.use(ColorPicker);
Vue.use(Transfer);
Vue.use(Container);
Vue.use(Header);
Vue.use(Aside);
Vue.use(Main);
Vue.use(Footer);
Vue.use(Timeline);
Vue.use(TimelineItem);
Vue.use(Link);
Vue.use(Divider);
Vue.use(Image);
Vue.use(Calendar);
Vue.use(Backtop);
Vue.use(PageHeader);
Vue.use(CascaderPanel);
Vue.use(Loading.directive);
Vue.prototype.$loading = Loading.service;
Vue.prototype.$msgbox = MessageBox;
Vue.prototype.$alert = MessageBox.alert;
Vue.prototype.$confirm = MessageBox.confirm;
Vue.prototype.$prompt = MessageBox.prompt;
Vue.prototype.$notify = Notification;
Vue.prototype.$message = Message;
全局配置
在引入 Element 时,可以传入一个全局配置对象。该对象目前支持 size 与 zIndex 字段。size 用于改变组件的默认尺寸,zIndex 设置弹框的初始 z-index(默认值:2000)。按照引入 Element 的方式,具体操作如下:
完整引入 Element:
import Vue from 'vue';
import Element from 'element-ui';
Vue.use(Element, { size: 'small', zIndex: 3000 });
按需引入 Element:
import Vue from 'vue';
import { Button } from 'element-ui';
Vue.prototype.$ELEMENT = { size: 'small', zIndex: 3000 };
Vue.use(Button);
按照以上设置,项目中所有拥有 size
属性的组件的默认尺寸均为 ‘small’,弹框的初始 z-index 为 3000。
开始使用
至此,一个基于 Vue 和 Element 的开发环境已经搭建完毕,现在就可以编写代码了。各个组件的使用方法参可以阅它们各自的文档。