Element UI
1.Element UI 引言
官网: https://element.eleme.io/#/zh-CN
1.1 官方定义
Element - UI
1.2 定义
element ui 就是基于vue的一个ui框架,该框架基于vue开发了很多相关组件,方便我们快速开发页面。
1.3 由来
饿了么前端团队 基于vue进行开发并且进行了开源 element ui 中提供全部都是封装好组件。
饿了么
1.4 安装Element UI
1.4.1 通过vue脚手架创建项目
1.4.2 在vue脚手架项目中安装element ui
- npm 安装
推荐使用 npm 的方式安装,它能更好地和 webpack 打包工具配合使用。
1.下载element ui的依赖
npm i element-ui -S
2.指定当前项目中使用element ui
//在【main.js】中指定当前项目中使用element ui
import ElementUI from 'element-ui';
import 'element-ui/lib/theme-chalk/index.css';
//在vue脚手架中使用element ui
Vue.use(ElementUI);
//在main.js中导入ElementUI插件
import Vue from 'vue'
import App from './App.vue'
import router from './router'
import store from './store'
import ElementUI from 'element-ui';
import 'element-ui/lib/theme-chalk/index.css';
Vue.config.productionTip = false
//Vue.use用来安装插件
//该方法需要在调用 new Vue() 之前被调用。
Vue.use(ElementUI);
new Vue({
router,
store,
render: h => h(App)
}).$mount('#app')
2.Layout(栅格)布局组件的使用
通过基础的 24 分栏,迅速简便地创建布局
在element ui中布局组件将页面划分为多个行row ,每行最多分为24栏(列)
注意
- 在一个布局组件中是由 row 和 col 组合而成
- 在使用时要区分 row 属性和 col 属性
2.1 属性的使用
- 行属性使用
<el-row :gutter="20">
<el-col :span="6"><div class="grid-content bg-purple"></div></el-col>
<el-col :span="6"><div class="grid-content bg-purple"></div></el-col>
<el-col :span="6"><div class="grid-content bg-purple"></div></el-col>
<el-col :span="6"><div class="grid-content bg-purple"></div></el-col>
</el-row>
- 列属性使用
<el-row :gutter="20">
<el-col :span="6"><div class="grid-content bg-purple"></div></el-col>
<el-col :span="6" :offset="8"><div class="grid-content bg-purple"></div></el-col>
</el-row>
3.Container 布局容器组件
3.1 创建布局容器
<el-container></el-container>
3.2 容器中包含的子元素
<el-header>:顶栏容器。
<el-aside>:侧边栏容器。
<el-main>:主要区域容器。
<el-footer>:底栏容器。
3.3 容器的嵌套使用
<el-container>
<!-- 容器的嵌套使用 -->
<el-header>Header</el-header>
<el-container>
<el-aside width="200px">Aside</el-aside>
<el-container>
<el-main>Main</el-main>
<el-footer>Footer</el-footer>
</el-container>
</el-container>
</el-container>
3.4 水平与垂直容器
<el-container direction="vertical">
<!-- 水平与垂直容器的使用 -->
<el-header>Header</el-header>
<el-container>
<el-aside width="200px">Aside</el-aside>
<el-container direction="horizontal">
<el-main>Main</el-main>
<el-footer>Footer</el-footer>
</el-container>
</el-container>
</el-container>
注意:当子元素中没有有 el-header 或 el-footer 时容器排列为水平
3.5 子容器属性
子容器 | 参数 | 说明 | 默认值 |
Header Attributes | height | 顶栏高度 | 60px |
Aside Attributes | width | 侧边栏高度 | 300px |
Footer Attributes | height | 底栏高度 | 60px |
4.Form相关组件
4.1 Radio单选框
4.1.1 创建按钮
<template>
<el-radio v-model="radio" label="1">备选项</el-radio>
<el-radio v-model="radio" label="2">备选项</el-radio>
</template>
<script>
export default {
data () {
return {
radio: '1'
};
}
}
</script>
注意:在使用 radio 单选按钮时,至少加入 v-model 和 label 两个属性
4.1.2 Radio按钮属性的使用
属性的使用还是直接写在对应的组件标签上以 属性名 = 属性值 的方式实现的。
4.1.3 Radio 事件的使用
事件的使用也是和属性使用是一致,都是直接写在对应的组件标签上
事件在使用时必须使用Vue中绑定事件方式进行,使用如@事件名=事件处理函数(绑在在vue组件中对应函数)
<template>
<el-radio v-model="radio" @change="changeRadio" label="1">备选项1</el-radio>
<el-radio v-model="radio" @change="changeRadio" label="2">备选项2</el-radio>
</template>
<script>
export default {
data () {
return {
radio: '1'
};
},
methods: {
changeRadio(){
alert(this.radio2);
},
}
}
</script>
4.1.4 Radio 按钮组
<template>
<el-radio-group v-model="radio3">
<el-radio label="3">123</el-radio>
<el-radio label="6">12</el-radio>
<el-radio label="9">1</el-radio>
</el-radio-group>
</template>
<script>
export default {
data () {
return {
radio: '1'
};
}
}
</script>
4.2 checkbox 多选框
<template>
<el-checkbox-group v-model="checkList">
<el-checkbox label="复选框 A"></el-checkbox>
<el-checkbox label="复选框 B"></el-checkbox>
<el-checkbox label="复选框 C"></el-checkbox>
<el-checkbox label="禁用" disabled></el-checkbox>
<el-checkbox label="选中且禁用" disabled></el-checkbox>
</el-checkbox-group>
<div>当前复选框的值为:{{checkList}}</div>
</template>
<script>
export default {
data () {
return {
checkList:['复选框 A','选中且禁用'],
};
}
}
</script>
4.3 Input 输入框组件
4.3.1 创建 Input 组件
请输入内容
<el-input v-model="input" placeholder="请输入内容"></el-input>
<script>
export default {
data() {
return {
input: ''
}
}
}
</script>
4.3.2 Input 组件属性
<el-input v-model="inputmean" style="width:400px;" placeholder="普通输入框"></el-input>
<br>
<el-input placeholder="可清空输入框" v-model="inputmean" style="width:400px;" clearable></el-input>
<br>
<el-input placeholder="密码输入框" v-model="inputmean" style="width:400px;" show-password></el-input>
<br>
<!-- row为文本高度 -->
<el-input type="textarea" :rows="2" placeholder="请输入内容" v-model="inputmean" style="width:400px;margin:5px;"></el-input>
<br>
<el-input type="textarea" autosize placeholder="请输入内容" v-model="inputmean" style="width:400px;"></el-input>
4.3.3 Input 输入事件的使用
<template>
<el-input
v-model="username"
@blur="aaa"
@focus="bbb"
@clear="clears"
clearable
@input="ccc"
placeholder="输入框事件的绑定"
></el-input>
</template>
<script>
export default {
data () {
return {
username:'',
};
},
methods: {
aaa() {
console.log("失去焦点");
},
bbb() {
console.log("获取焦点");
},
ccc(value) {
console.log("改变:" + value);
},
clears() {
console.log("清除");
},
}
}
</script>
4.3.4 Input组件中方法的使用
<template>
<el-input v-model="username" ref="inputs" style="width: 400px"></el-input>
<el-button @click="focusInputs">focus方法</el-button>
<el-button @click="blurInputs">blur方法</el-button>
<el-button @click="selectInputs">select方法</el-button>
</template>
<script>
export default {
data () {
return {
username:'',
};
},
methods: {
focusInputs(){
this.$refs.inputs.focus();
},
blurInputs(){
this.$refs.inputs.blur();
},
selectInputs(){
this.$refs.inputs.select();
}
}
}
</script>
在使用组件的方法时需要在对应的组件中加入ref="组件别名”
在调用方法时直接使用this.$refs .组件别名.方法名()
4.4 Select 选择器(下拉列表)组件的使用
4.4.1 Select 选择器组件的创建
<template>
<div id="container">
<el-select v-model="value" placeholder="请选择">
<el-option
v-for="item in options"
:key="item.value"
:label="item.label"
:value="item.value"
>
<!-- 遍历options数组 -->
</el-option>
</el-select>
</div>
</template>
<script>
export default {
name: "select.vue",
data() {
return {
options: [
{
value: "选项1",
label: "黄金糕",
},
{
value: "选项2",
label: "双皮奶",
},
{
value: "选项3",
label: "蚵仔煎",
},
],
value: "",
// value为当前选定的值
};
},
};
</script>
<style>
</style>
注意:1.要求下拉列表中必须存在option的value属性值 ⒉.要求select中必须使用v-model进行数据绑定
4.4.2 Select 组件的属性
…
4.4.3 Select 组件事件的使用
4.5 Switch 组件的使用
4.5.1 Switch 组件的创建
<el-switch
v-model="value"
active-color="#13ce66"
inactive-color="#ff4949">
</el-switch>
<script>
export default {
data() {
return {
value: true
}
}
};
</script>
4.5.2 Switch组件的属性使用
4.5.3 Switch组件的事件使用
4.6 DateTimePicker 日期时间选择器
4.6.1 DateTimerPicker 组件的创建
<template>
<div class="block">
<span class="demonstration">默认</span>
<el-date-picker
v-model="value1"
type="datetime"
placeholder="选择日期时间">
</el-date-picker>
</div>
</template>
<script>
export default {
data() {
return {
value1: '',
};
}
};
</script>
4.6.2 DateTimerPicker 组件的属性
4.7 Upload 组件
4.7.1 Upload 组件创建
<el-upload
action="https://jsonplaceholder.typicode.com/posts/"
:file-list="fileList"
>
<el-button size="small" type="primary">点击上传</el-button>
<div slot="tip" class="el-upload__tip">
只能上传jpg/png文件,且不超过500kb
</div>
</el-upload>
注意:在使用upload组件时必须设置action属性,action属性为必要参数不能省略
4.7.2 Upload 组件属性
4.8 Form 表单组件
4.8.1 Form 组件的创建
<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>
<el-button type="primary" @click="onSubmit">立即创建</el-button>
<el-button>取消</el-button>
</el-form-item>
</el-form>
</template>
<script>
export default {
name: "form.vue",
data() {
return {
form: {
name: '',
region: '',
date1: '',
date2: '',
delivery: false,
type: [],
resource: '',
desc: ''
}
}
},
methods: {
onSubmit() {
console.log('submit!');
}
}
};
</script>
4.8.2 内联表单
当垂直方向空间受限且表单较简单时,可以在一行内放置表单。
<el-form :inline="true" :model="formInline" class="demo-form-inline">
........
</el-form>
<script>
export default {
data() {
return {}
},
methods: {
}
}
</script>
4.8.3 Form 表单属性
4.8.4 表单验证(失去焦点自动验证)
<el-form :model="ruleForm" :rules="rules" >
<!-- 在rules属性指定rules规则,才能使用规则 -->
<!-- 使用prop给组件传参,通过rules中的命令参数来定义规则 -->
<el-form-item label="活动名称" prop="name">
<el-input v-model="ruleForm.name"></el-input>
</el-form-item>
</el-form>
<script>
export default {
name: "form.vue",
data() {
return {
ruleForm: {
name: "",
},
rules: {
name: [
{ required: true, message: "请输入活动名称", trigger: "blur" },
{ min: 3, max: 5, message: "长度在 3 到 5 个字符", trigger: "blur" },
],
},
};
},
};
</script>
4.8.4 表单验证(失去焦点自动验证)
<el-form :rules="rules" .... ref="ruleForm">
<!-- 在rules属性指定rules规则,才能使用规则 -->
<!-- 使用prop给组件传参,通过rules中的命令参数来定义规则 -->
<el-form-item label="活动名称" prop="name">
<el-input v-model="ruleForm.name"></el-input>
</el-form-item>
<el-form-item>
<!-- 提交时,传递了当前组件的别名ruleForm,调用验证方法,在提交时还可以做验证 -->
<el-button type="primary" @click="submitForm('ruleForm')">立即创建</el-button>
<el-button @click="resetForm('ruleForm')">重置</el-button>
</el-form-item>
</el-form>
<script>
export default {
name: "form.vue",
data() {
return {}
},
methods: {
submitForm(formName) {
this.$refs[formName].validate((valid) => {
if (valid) {
alert("submit!");
} else {
console.log("error submit!!");
return false;
}
});
},
resetForm(formName) {
this.$refs[formName].resetFields();
},
},
};
</script>
5 Notice 组件
5.1 Alert 组件
5.1.1 Alert 组件的创建
<template>
<div id="container">
<el-alert title="成功提示的文案" type="success"> </el-alert>
<el-alert title="消息提示的文案" type="info"> </el-alert>
<el-alert title="成功提示的文案" type="success" effect="dark"> </el-alert>
<el-alert title="消息提示的文案" type="info" effect="dark"> </el-alert>
<el-alert title="自定义 close-text" type="info" close-text="知道了">
</el-alert>
</div>
</template>
<script>
export default {
name: "alert.vue",
};
</script>
<style>
#container .el-alert {
margin: 20px;
}
</style>
5.1.2 Alert 组件的属性
5.2 Message 消息提示组件
5.2.1 Message 组件的创建
<template>
<el-button :plain="true" @click="open">打开消息提示</el-button>
<el-button :plain="true" @click="openVn">VNode</el-button>
</template>
<script>
export default {
methods: {
open() {
this.$message('这是一条消息提示');
},
openVn() {
const h = this.$createElement;
this.$message({
message: h('p', null, [
h('span', null, '内容可以是 '),
h('i', { style: 'color: teal' }, 'VNode')
])
});
}
}
}
</script>
注意:这个组件的创建无须在页面中书写任何标签,他是一个js插件,在需要展示消息提示的位置直接调用提供的js插件方法即可
6 表格组件
6.1 Table 组件
6.1.1 Table组件的创建
<template>
<div>
<el-table :data="tableData">
<el-table-column prop="id" label="编号"></el-table-column>
<el-table-column prop="name" label="姓名"></el-table-column>
<el-table-column prop="age" label="年龄"></el-table-column>
<el-table-column prop="email" label="邮箱"></el-table-column>
</el-table>
</div>
</template>
<script>
export default {
name: "table.vue",
data() {
return {
tableData: [
{ id: 1, name: "小张", age: "20", email: "123456@qq.com" },
{ id: 2, name: "张", age: "20", email: "12345@qq.com" },
],
};
},
};
</script>
6.1.2 表格中的属性