大家好!今天让小编来大家介绍下关于elementui学习笔记的问题,以下是酷知号的小编对此问题的归纳整理,让我们一起来看看吧。
layout 布局
整个页面宽度分位24栏
基础布局
"24">基础布局
分栏之间存在间隔。
"20"> "16"> class="grid-content bg-purple">"8"> class="grid-content bg-purple">
分栏之间存在偏移
"20"> "6"> class="grid-content bg-purple">"6" :offset="6"> class="grid-content bg-purple">
使用flex布局:
将 type
属性赋值为 ‘flex’,可以启用 flex 布局,并可通过 justify
属性来指定 start, center, end, space-between, space-around 其中的值来定义子元素的排版方式。
"flex" class="row-bg"> "6"> class="grid-content bg-purple">"6"> class="grid-content bg-purple-light">"6"> class="grid-content bg-purple">
响应式布局
参照了 bootstrap 的 响应式设计,预设了五个响应尺寸:xs
、、
md
、lg
和 xl
。
"10"> "8" :="6" :md="4" :lg="3" :xl="1"> class="grid-content bg-purple">"4" :="6" :md="8" :lg="9" :xl="11"> class="grid-content bg-purple-light">"4" :="6" :md="8" :lg="9" :xl="11"> class="grid-content bg-purple">"8" :="6" :md="4" :lg="3" :xl="1"> class="grid-content bg-purple-light">
基于断点的隐藏类
element 额外提供了一系列类名,用于在某些条件下隐藏元素。这些类名可以添加在任何 dom 元素或自定义组件上。如果需要,请自行引入以下文件:
import 'element-ui/lib/theme-chalk/display.css';
包含的类名及其含义为: hidden-xs-only - 当视口在 xs 尺寸时隐藏 hidden--only - 当视口在 尺寸时隐藏 hidden--and-down - 当视口在 及以下尺寸时隐藏 hidden--and-up - 当视口在 及以上尺寸时隐藏 hidden-md-only - 当视口在 md 尺寸时隐藏 hidden-md-and-down - 当视口在 md 及以下尺寸时隐藏 hidden-md-and-up - 当视口在 md 及以上尺寸时隐藏 hidden-lg-only - 当视口在 lg 尺寸时隐藏 hidden-lg-and-down - 当视口在 lg 及以下尺寸时隐藏 hidden-lg-and-up - 当视口在 lg 及以上尺寸时隐藏 hidden-xl-only - 当视口在 xl 尺寸时隐藏
container 布局容器
:外层容器。当子元素中包含
或
时,全部子元素会垂直上下排列,否则会水平左右排列。
:顶栏容器。
:侧边栏容器。
:主要区域容器。
:底栏容器。
以上组件采用了 flex 布局,使用前请确定目标浏览器是否兼容。此外,
的子元素只能是后四者,后四者的父元素也只能是
。
container attributes:
direction子元素的排列方向,horizontal / vertical,子元素中有 el-header
或 el-footer
时为 vertical,否则为 horizontal
header attributes:height:60px 默认
aside attributes:侧边栏宽度,默认300px
footer attributes:高度,默认60px;
color 色彩
element 为了避免视觉传达差异,使用一套特定的调色板来规定颜色,为你所搭建的产品提供一致的外观视觉感受。
主色,辅助色,中性色
typography 字体
我们对字体进行统一规范,力求在各个操作系统下都有最佳展示效果。
icon 图标
提供了一套常用的图标集合。诸多元素图标参照官方说明
class="el-icon-edit"> class="el-icon-share"> class="el-icon-delete">"primary" icon="el-icon-search">搜索
button 按钮
基础用法
使用type
、plain
、round
和circle
属性来定义 button 的样式。
默认按钮 "primary">主要按钮 "success">成功按钮 "info">信息按钮 "warning">警告按钮 "danger">危险按钮
禁用状态你可以使用disabled
属性来定义按钮是否可用,它接受一个boolean
值。
文字按钮:没有边框和背景色的按钮。
"text">文字按钮 "text" disabled>文字按钮
图标按钮:
"primary" icon="el-icon-delete"> "primary" icon="el-icon-search">搜索
按钮组
"primary" icon="el-icon-arrow-left">上一页 "primary">下一页class="el-icon-arrow-right el-icon--right">
加载中按钮
"primary" :loading="true">加载中
不同尺寸:size:medium,all ini
默认按钮 "medium">中等按钮 "all">小型按钮 "mini">超小按钮 默认按钮 "medium" round>中等按钮 "all" round>小型按钮 "mini" round>超小按钮
属性里面见得少的
autofocus 是否默认聚焦 boolean — false native-type 原生 type 属性 string button / submit / reset button
link 文字链接
基本用法
"https://element.eleme.io" target="_blank">默认链接
禁用状态
<el-link disabled>默认链接el-link>
有无下划线
<div>
<el-link :underline="false">无下划线el-link>
<el-link>有下划线el-link>
div>
带图标
<div>
<el-link icon="el-icon-edit">编辑el-link>
<el-link>查看<i class="el-icon-view el-icon--right">i> el-link>
div>
radio 单选框:
要使用 radio 组件,只需要设置v-model
绑定变量,选中意味着变量的值为相应 radio label
属性的值,label
可以是string
、number
或boolean
。
"radio" label="1">备选项 "radio" label="2">备选项
禁用状态:只要在el-radio
元素中设置disabled
属性即可,它接受一个boolean
,true
为禁用
单选框组:互斥单选框 另外,还提供了change
事件来响应变化,它会传入一个参数value
。
"radio" v-on:change="change"> "3">备选项 "6">备选项 "9">备选项
按钮样式:按钮样式的单选框 还提供size 属性
"radio2" size="medium"> "上海" > "北京"> "广州"> "深圳">
设置border可以加边框
"radio1" label="1" border>备选项1 "radio1" label="2" border>备选项2
checkbox 多选框
基本用法
,如需禁用设置disabled
属性即可"checked">备选项
多选框组
checkbox-group
元素能把多个 checkbox 管理为一组,只需要在 group 中使用v-model
绑定array
类型的变量即可。
el-checkbox
的 label
属性是该 checkbox 对应的值,若该标签中无内容,则该属性也充当 checkbox 按钮后的介绍。
label
与数组中的元素值相对应,如果存在指定的值则为选中状态,否则为不选中。
"checklist"> "复选框 a"> "复选框 b"> "复选框 c"> "禁用" disabled> "选中且禁用" disabled>
indeterminate 状态
indeterminate
属性用以表示 checkbox 的不确定状态”-“),全选是打钩,全不选是空,部分选中是横岗,也就是true 展现横岗
checkbox :indeterminate="checkedcities.length>0&&checkedcities.length<4" v-model="checkall" @change="handlecheckallchange">全选 "margin: 15px 0;">"checkedcities" @change="handlecheckedcitieschange"> for="city in cities" :label="city" :key="city">{{city}}
可选项目数量的限制:使用 min
和 max
属性能够限制可以被勾选的项目的数量。
group v-model="checkedcities" :min="1" :max="2"> for="city in cities" :label="city" :key="city">{{city}}
按钮样式的多选和边框border):
只需要把el-checkbox
元素替换为el-checkbox-button
元素即可。此外,element 还提供了size
属性。
设置border
属性可以渲染为带有边框的多选框。
input 输入框
可清除输入框
input placeholder="请输入内容" v-model="input" clearable>
密码输入框
带 icon 的输入框
class="demo-input-suffix"> 属性方式:input placeholder="请选择日期" suffix-icon="el-icon-date" v-model="input1"> input placeholder="请输入内容" prefix-icon="el-icon-search" v-model="input2"> class="demo-input-suffix"> slot 方式:input placeholder="请选择日期" v-model="input3">"suffix" class="el-input__icon el-icon-date">
input placeholder="请输入内容" v-model="input4"> "prefix" class="el-input__icon el-icon-search">
textarea:可以通过:rows控制行数
input type="textarea" :rows="2" placeholder="请输入内容" v-model="textarea">
可自适应文本高度的文本域:type=”textarea”
input type="textarea" autosize placeholder="请输入内容" v-model="textarea1"> "margin: 20px 0;">input type="textarea" :autosize="{ minrows: 2, maxrows: 4}" placeholder="请输入内容" v-model="textarea2">
复合型输入框
可前置或后置元素,一般为标签或按钮
"请输入内容" v-model="input1"> "prepend">http:// "margin-top: 15px;">"请输入内容" v-model="input2"> "append">.com "margin-top: 15px;">"请输入内容" v-model="input3" class="input-with-select"> "select" slot="prepend" placeholder="请选择"> "餐厅名" value="1"> "订单号" value="2"> "用户电话" value="3"> "append" icon="el-icon-search">
尺寸:可通过 size
属性指定输入框的尺寸,除了默认的大小外,还提供了 large、all 和 mini 三种尺寸。
input size="medium" placeholder="请输入内容" suffix-icon="el-icon-date" v-model="input2">
带输入建议:autocomplete 是一个可带输入建议的输入框组件,fetch-suggestions
是一个返回输入建议的方法属性,
如 querysearchquerystring, cb),在该方法中你可以在你的输入建议数据准备好时通过 cbdata) 返回到 autocomplete 组件中。
可配合clearable实现清除,:trigger-on-focus=“false” 可以控制点击是否弹出备选项
效果:
代码:
class="demo-autocomplete"> "12"> class="sub-title">激活即列出输入建议autocomplete class="inline-input" v-model="state1" :fetch-suggestions="querysearch" placeholder="请输入内容" @select="handleselect" > "12"> class="sub-title">输入后匹配输入建议autocomplete class="inline-input" v-model="state2" :fetch-suggestions="querysearch" placeholder="请输入内容" :trigger-on-focus="false" @select="handleselect" >
自定义模板:可自定义输入建议的显示内容和样式
使用scoped slot自定义输入建议的模板。 该 scope 的参数为item,表示当前输入建议对象。autocomplete popper-class="my-autocomplete" v-model="state" :fetch-suggestions="querysearch" placeholder="请输入内容" @select="handleselect"> <i class="el-icon-edit el-input__icon" slot="suffix" @click="handleiconclick"> "{ item }"> class="name">{{ item.value }}class="addr">{{ item.address }}
异步获取数据填充:
autocomplete v-model="state" :fetch-suggestions="querysearchasync" placeholder="请输入内容" @select="handleselect" >
长度限制
maxlength 和 minlength 是原生属性,用来限制输入框的字符长度,其中字符长度是用 jascript 的字符串长度统计的。对于类型为 text 或 textarea 的输入框,在使用 maxlength 属性限制最大输入长度的同时,可通过设置 show-word-limit 属性来展示字数统计。
<el-input type="text" placeholder="请输入内容" v-model="text" maxlength="10" show-word-limit >
还有相关的一系列对外事件
inputnumber 计数器:
"num" @change="handlechange" :min="1" :max="10" label="描述文字">
禁用
步数
"num" :step="2">
严格倍数
step-strictly属性接受一个boolean。如果这个属性被设置为true,则只能输入步数的倍数。
精度:
尺寸
"num1"> "medium" v-model="num2"> "all" v-model="num3"> "mini" v-model="num4">
按钮位置
select 选择器
基础用法
"value" placeholder="请选择"> option v-for="item in options" :key="item.value" :label="item.label" :value="item.value">
有禁用项目
"value" placeholder="请选择"> option v-for="item in options" :key="item.value" :label="item.label" :value="item.value" :disabled="item.disabled">
禁用状态,不可选
"value" disabled placeholder="请选择"> option v-for="item in options" :key="item.value" :label="item.label" :value="item.value">
可清空单选
"value" clearable placeholder="请选择"> option v-for="item in options" :key="item.value" :label="item.label" :value="item.value">
多选
为el-select
设置multiple
属性即可启用多选,此时v-model
的值为当前选中值所组成的数组。默认情况下选中值会以 tag 的形式展现,你也可以设置collapse-tags
属性将它们合并为一段文字。
"value1" multiple placeholder="请选择"> option v-for="item in options" :key="item.value" :label="item.label" :value="item.value"> select v-model="value2" multiple collapse-tags style="margin-left: 20px;" placeholder="请选择"> option v-for="item in options" :key="item.value" :label="item.label" :value="item.value">
自定义模板
"value" placeholder="请选择"> option v-for="item in cities" :key="item.value" :label="item.label" :value="item.value"> "float: left">{{ item.label }} "float: right; color: #8492a6; font-size: 13px">{{ item.value }}
分组:
"value" placeholder="请选择"> group v-for="group in options" :key="group.label" :label="group.label"> option v-for="item in group.options" :key="item.value" :label="item.label" :value="item.value">
可搜索
为el-select
添加filterable
属性即可启用搜索功能。默认情况下,select 会找出所有label
属性包含输入值的选项。
如果希望使用其他的搜索逻辑,可以通过传入一个filter-method
来实现。filter-method
为一个function
,它会在输入值发生变化时调用,参数为当前输入值。
"value" filterable placeholder="请选择"> option v-for="item in options" :key="item.value" :label="item.label" :value="item.value">
远程搜索
为了启用远程搜索,需要将filterable
和remote
设置为true
,同时传入一个remote-method
。
remote-method
为一个function
,它会在输入值发生变化时调用,参数为当前输入值。
需要注意的是,如果el-option
是通过v-for
指令渲染出来的,此时需要为el-option
添加key
属性,且其值需具有唯一性,比如此例中的item.value
。
select v-model="value" multiple filterable remote reserve-keyword placeholder="请输入关键词" :remote-method="remotemethod" :loading="loading"> option v-for="item in options" :key="item.value" :label="item.label" :value="item.value">
创建条目:
使用allow-create属性即可通过在输入框中输入文字来创建新的条目。
注意此时filterable必须为真
本例还使用了default-first-option属性,在该属性打开的情况下,按下回车就可以选中当前选项列表中的第一个选项,无需使用鼠标或键盘方向键进行定位。
select v-model="value" multiple filterable allow-create default-first-option placeholder="请选择文章标签"> option v-for="item in options" :key="item.value" :label="item.label" :value="item.value">
cascader 级联选择器
switch 开关
switch v-model="value" active-color="#13ce66" inactive-color="#ff4949"> switch v-model="value1" active-text="按月付费" inactive-text="按年付费"> switch v-model="value" active-color="#13ce66" inactive-color="#ff4949" active-value="100" inactive-value="0"> switch v-model="value1" disabled>
slider 滑块
通过拖动滑块在一个固定区间内进行选择
class="block"> class="demonstration">默认"value1"> class="block"> class="demonstration">自定义初始值"value2"> class="block"> class="demonstration">隐藏 tooltip"value3" :show-tooltip="false"> class="block"> class="demonstration">格式化 tooltip"value4" :format-tooltip="formattooltip"> class="block"> class="demonstration">禁用"value5" disabled>
离散值:改变step
的值可以改变步长,通过设置show-stops
属性可以显示间断点
带有输入框
class="block">slider v-model="value" show-input>
class="block">slider v-model="value" range show-stops :max="10">
class="block">slider v-model="value" vertical height="200px">
class="block">slider v-model="value" range :marks="marks">
dialog 对话框
tag 标签
用于标记和选择。
用type和color定义tag颜色标签一 "success">标签二 "info">标签三 "warning">标签四 "danger">标签五
可移除样式
设置closable属性可以定义一个标签是否可移除。默认的标签移除时会附带渐变动画,如果不想使用,可以设置disable-transitions属性,它接受一个boolean,true 为关闭。tag v-for="tag in tags" :key="tag.name" closable :type="tag.type"> {{tag.name}}
动态编辑标签
动态编辑标签可以通过点击标签关闭按钮后触发的 close
事件来实现
不同尺寸:
默认标签 "medium" closable>中等标签 "all" closable>小型标签 "mini" closable>超小标签
不同主题和tag组
tag 组件提供了三个不同的主题:dark
、light
和 plain
class="tag-group"> class="tag-group__title">darktag v-for="item in items" :key="item.label" :type="item.type" effect="dark"> {{ item.label }} class="tag-group"> class="tag-group__title">plaintag v-for="item in items" :key="item.label" :type="item.type" effect="plain"> {{ item.label }}
progress 进度条
用于展示操作进度,告知用户当前状态和预期。
线形进度条
progress 组件设置percentage属性即可,表示进度条对应的百分比,必填,必须在 0-100。通过 format 属性来指定进度条文字内容。"50"> "100" :format="format"> "100" status="success"> "100" status="warning"> "50" status="exception">
百分比内显
百分比不占用额外控件,适用于文件上传等场景。
"true" :stroke-width="26" :percentage="70"> "true" :stroke-width="24" :percentage="100" status="success"> "true" :stroke-width="22" :percentage="80" status="warning"> "true" :stroke-width="20" :percentage="50" status="exception">
自定义颜色
可以通过 color
设置进度条的颜色,color
可以接受颜色字符串,函数和数组。
el-progress :percentage="percentage" :color="customcolor">"percentage" :color="customcolormethod"> "percentage" :color="customcolors"> "el-icon-minus" @click="decrease"> "el-icon-plus" @click="increase">
环形进度条
progress 组件可通过 type
属性来指定使用环形进度条,在环形进度条中,还可以通过 width
属性来设置其大小。
"circle" :percentage="0"> "circle" :percentage="25"> "circle" :percentage="100" status="success"> "circle" :percentage="70" status="warning"> "circle" :percentage="50" status="exception">
仪表盘形进度条
"dashboard" :percentage="percentage" :color="colors"> "el-icon-minus" @click="decrease"> "el-icon-plus" @click="increase">
transfer 穿梭框
"value" :data="data"> value: [1, 4] data:[{ key: i, label: `备选项 ${ i }`, disabled: i % 4 === 0 }] transfer 的数据通过 data 属性传入。数据需要是一个对象数组,每个对象有以下属性:key 为数据的唯一性标识,label 为显示文本,disabled 表示该项数据是否禁止转移。
目标列表中的数据项会同步到绑定至 v-model 的变量,值为数据项的 key 所组成的数组。当然,如果希望在初始状态时目标列表不为空,可以像本例一样为 v-model 绑定的变量赋予一个初始值。
可搜索的穿梭框
transfer filterable :filter-method="filtermethod" filter-placeholder="请输入城市拼音" v-model="value" :data="data"> 设置 filterable 为 true 即可开启搜索模式。 默认情况下,若数据项的 label 属性包含搜索关键字,则会在搜索结果中显示。 你也可以使用 filter-method 定义自己的搜索逻辑。filter-method 接收一个方法,当搜索关键字变化时,会将当前的关键字和每个数据项传给该方法。若方法返回 true,则会在搜索结果中显示对应的数据项。
可自定义
可以对列表标题文案、按钮文案、数据项的渲染函数、列表底部的勾选状态文案、列表底部的内容区等进行自定义。
可以使用 titles
、button-texts
、render-content
和 format
属性分别对列表标题文案、按钮文案、数据项的渲染函数和列表顶部的勾选状态文案进行自定义。数据项的渲染还可以使用 scoped-slot
进行自定义。对于列表底部的内容区,提供了两个具名 slot:left-footer
和 right-footer
。此外,如果希望某些数据项在初始化时就被勾选,可以使用 left-default-checked
和 right-default-checked
属性。最后,本例还展示了 change
事件的用法。注意:由于 jsfiddle 不支持 jsx 语法,所以使用 render-content
自定义数据项的例子在 jsfiddle 中无法运行。但是在实际的项目中,只要正确地配置了相关依赖,就可以正常运行。
"text-align: center; margin: 0 0 20px">使用 render-content 自定义数据项
"text-align: center">transfer style="text-align: left; display: inline-block" v-model="value" filterable :left-default-checked="[2, 3]" :right-default-checked="[1]" :render-content="renderfunc" :titles="['source', 'target']" :button-texts="['到左边', '到右边']" :format="{ nochecked: '${total}', haschecked: '${checked}/${total}' }" @change="handlechange" :data="data"> class="transfer-footer" slot="left-footer" size="all">操作 class="transfer-footer" slot="right-footer" size="all">操作
"text-align: center; margin: 50px 0 20px">使用 scoped-slot 自定义数据项
"text-align: center">transfer style="text-align: left; display: inline-block" v-model="value4" filterable :left-default-checked="[2, 3]" :right-default-checked="[1]" :titles="['source', 'target']" :button-texts="['到左边', '到右边']" :format="{ nochecked: '${total}', haschecked: '${checked}/${total}' }" @change="handlechange" :data="data"> "{ option }">{{ option.key }} - {{ option.label }} class="transfer-footer" slot="left-footer" size="all">操作 class="transfer-footer" slot="right-footer" size="all">操作
数据项属性别名
默认情况下,transfer 仅能识别数据项中的 key
、label
和 disabled
字段。如果你的数据的字段名不同,可以使用 props
属性为它们设置别名。
:props="{ key: 'value', label: 'desc' }"
通知框类:
基础用法
type:info,success,warning,error
主题
alert 组件提供了两个不同的主题:light
和dark
。
alert title="成功提示的文案" type="success" effect="dark">
自定义关闭按钮
在 alert 组件中,你可以设置是否可关闭,关闭按钮的文本以及关闭时的回调函数。
closable
属性决定是否可关闭,接受boolean
,默认为true
。
你可以设置close-text
属性来代替右侧的关闭图标,
注意:close-text
必须为文本。
设置close
事件来设置关闭时的回调。
alert title="不可关闭的 alert" type="success" :closable="false"> alert title="自定义 close-text" type="info" close-text="知道了"> alert title="设置了回调的 alert" type="warning" @close="hello">
带有 icon
通过设置show-icon
属性来显示 alert 的 icon,这能更有效地向用户展示你的显示意图。
文字居中
使用 center
属性让文字水平居中。
"成功提示的文案" type="success" center show-icon>
带有辅文字介绍
包含标题和内容,解释更详细的警告。
除了必填的title
属性外,你可以设置description
属性来帮助你更好地介绍,我们称之为辅文字。辅文字只能存放单行文本,会自动换行显示。
alert title="带辅文字介绍" type="success" description="这是一句绕口令:黑灰化肥会挥发发灰黑化肥挥发;灰黑化肥会挥发发黑灰化肥发挥。 黑灰化肥会挥发发灰黑化肥黑灰挥发化为灰……">
带有 icon 和辅文字介绍:show-icon和description组合使用
loading 加载
区域加载
在表格等容器中加载数据时显示。
element 提供了两种调用 loading 的方法:指令和服务。
对于自定义指令v-loading
,只需要绑定boolean
即可。
默认状况下,loading 遮罩会插入到绑定元素的子节点,
通过添加body
修饰符,可以使遮罩插入至 dom 中的 body 上。
table v-loading="loading" :data="tabledata" style=" 100%"> column prop="date" label="日期" width="180"> column prop="name" label="姓名" width="180"> column prop="address" label="地址">
自定义
可自定义加载文案、图标和背景色。
在绑定了v-loading
指令的元素上添加element-loading-text
属性,其值会被渲染为加载文案,并显示在加载图标的下方。类似地,element-loading-spinner
和element-loading-background
属性分别用来设定图标类名和背景色值。
table v-loading="loading" element-loading-text="拼命加载中" element-loading-spinner="el-icon-loading" element-loading-background="rgba0, 0, 0, 0.8)" :data="tabledata" style=" 100%">
整页加载
页面数据加载时显示。
当使用指令方式时,全屏遮罩需要添加fullscreen
修饰符(遮罩会插入至 body 上),此时若需要锁定屏幕的滚动,可以使用lock
修饰符;
当使用服务方式时,遮罩默认即为全屏,无需额外设置。
button type="primary" @click="openfullscreen1" v-loading.fullscreen.lock="fullscreenloading"> 指令方式 button type="primary" @click="openfullscreen2"> 服务方式
export default { data) { return { fullscreenloading: false } }, methods: { openfullscreen1) { this.fullscreenloading = true; settimeout) => { this.fullscreenloading = false; }, 2000); }, openfullscreen2) { const loading = this.$loading{ lock: true, text: 'loading', spinner: 'el-icon-loading', background: 'rgba0, 0, 0, 0.7)' }); settimeout) => { loading.close); }, 2000); } } }
ndoe 环境服务注入
import { loading } from 'element-ui'; loading.serviceoptions); let loadinginstance = loading.serviceoptions); this.$nexttick) => { // 以服务的方式调用的 loading 需要异步关闭 loadinginstance.close); }); 需要注意的是,以服务的方式调用的全屏 loading 是单例的: 若在前一个全屏 loading 关闭前再次调用全屏 loading,并不会创建一个新的 loading 实例,而是返回现有全屏 loading 的实例: let loadinginstance1 = loading.service{ fullscreen: true }); let loadinginstance2 = loading.service{ fullscreen: true }); console.logloadinginstance1 === loadinginstance2); // true 如果完整引入了 element,那么 vue.prototype 上会有一个全局方法 $loading,它的调用方式为:this.$loadingoptions),同样会返回一个 loading 实例。
message 消息提示
常用于主动操作后的反馈提示。与 notification 的区别是后者更多用于系统级通知的被动提醒。
基础用法:从顶部出现,3 秒后自动消失。element 注册了一个$message
方法用于调用,message 可以接收一个字符串或一个 vnode 作为参数,它会被显示为正文内容。
不同状态:用来显示「成功、警告、消息、错误」类的操作反馈。当需要自定义更多属性时,message 也可以接收一个对象为参数。比如,设置type
字段可以定义不同的状态,默认为info
。此时正文内容以message
的值传入。同时,我们也为 message 的各种 type 注册了方法,可以在不传入type
字段的情况下像open4
那样直接调用
可关闭:可以添加关闭按钮。
this.$message{ showclose: true, message: '恭喜你,这是一条成功消息', type: 'success' });
文字居中:添加添加属性:center:true
使用 html 片段 message
属性支持传入 html 片段
将dangerouslyusehtmlstring
属性设置为 true,message
就会被当作 html 片段处理
message
属性虽然支持传入 html 片段,但是在网站上动态渲染任意 html 是非常危险的,因为容易导致 xss 攻击。
因此在 dangerouslyusehtmlstring
打开的情况下,请确保 message
的内容是可信的,永远不要将用户提交的内容赋值给 message
属性。
methods: { openhtml) { this.$message{ dangerouslyusehtmlstring: true, message: '这是 html 片段' }); } }
全局方式:element 为 vue.prototype 添加了全局方法 $message。因此在 vue instance 中可以采用本页面中的方式调用 message
单独引用:单独引入 message
:
import { message } from 'element-ui'
此时调用方法为 messageoptions)
。我们也为每个 type 定义了各自的方法,如 message.successoptions)
。并且可以调用 message.closeall)
手动关闭所有实例。
messagebox 弹框
用于消息提示、确认消息和提交内容。messagebox 的作用是美化系统自带的 alert
、confirm
和 prompt
,因此适合展示较为简单的内容。如果需要弹出较为复杂的内容,请使用 dialog。
它模拟了系统的 alert
,无法通过按下 esc 或点击框外关闭
此例中接收了两个参数,message
和title
。值得一提的是,窗口被关闭后,它默认会返回一个promise
对象便于进行后续操作的处理。若不确定浏览器是否支持promise
,可自行引入第三方 polyfill 或像本例一样使用回调进行后续处理
消息提示.单个确认按钮
this.$alert'这是一段内容', '标题名称', { confirmbuttontext: '确定', callback: action => { this.$message{ type: 'info', message: `action: ${ action }` });
用户确认
调用$confirm方法即可打开消息提示,它模拟了系统的 confirm。 message box 组件也拥有极高的定制性,我们可以传入options作为第三个参数,它是一个字面量对象。 type字段表明消息类型,可以为success,error,info和warning,无效的设置将会被忽略。 注意,第二个参数title必须定义为string类型,如果是object,会被理解为options。 在这里我们用了 promise 来处理后续响应。 this.$confirm'此操作将永久删除该文件, 是否继续?', '提示', { confirmbuttontext: '确定', cancelbuttontext: '取消', type: 'warning' }).then) => { this.$message{ type: 'success', message: '删除成功!' }); }).catch) => { this.$message{ type: 'info', message: '已取消删除' }); });
inputbox:带校验的输入框
可以用inputpattern字段自己规定匹配模式 或者用inputvalidator规定校验函数,可以返回boolean或string,返回false或字符串时均表示校验未通过,同时返回的字符串相当于定义了inputerrormessage字段。 此外,可以用inputplaceholder字段来定义输入框的占位符。 this.$prompt'请输入邮箱', '提示', { confirmbuttontext: '确定', cancelbuttontext: '取消', inputpattern: /[w!#$%&'* /=?^_`{|}~-] ?:.[w!#$%&'* /=?^_`{|}~-] )*@?:[w]?:[w-]*[w])?.) [w]?:[w-]*[w])?/, inputerrormessage: '邮箱格式不正确' }).then{ value }) => { this.$message{ type: 'success', message: '你的邮箱是: ' value }); }).catch) => { this.$message{ type: 'info', message: '取消输入' }); });
自定义:可自定义配置不同内容。以上三个方法都是对$msgbox
方法的再包装。
本例直接调用$msgbox
方法,使用了showcancelbutton
字段,用于显示取消按钮。
另外可使用cancelbuttonclass
为其添加自定义样式,
使用cancelbuttontext
来自定义按钮文本。
此例还使用了beforeclose
属性,它的值是一个方法,会在 messagebox 的实例关闭前被调用,同时暂停实例的关闭。
它有三个参数:action
、实例本身和done
方法。使用它能够在关闭前对实例进行一些操作,比如为确定按钮添加loading
状态等;此时若需要关闭实例,可以调用done
方法(若在beforeclose
中没有调用done
,则实例不会关闭)
const h = this.$createelement; this.$msgbox{ title: '消息', message: h'p', null, [ h'span', null, '内容可以是 '), h'i', { style: 'color: teal' }, 'vnode') ]), showcancelbutton: true, confirmbuttontext: '确定', cancelbuttontext: '取消', beforeclose: action, instance, done) => { if action === 'confirm') { instance.confirmbuttonloading = true; instance.confirmbuttontext = '执行中...'; settimeout) => { done); settimeout) => { instance.confirmbuttonloading = false; }, 300); }, 3000); } else { done); } } }).thenaction => { this.$message{ type: 'info', message: 'action: ' action }); });
说明:弹出层的内容可以是 vnode
,所以我们能把一些自定义组件传入其中。每次弹出层打开后,vue 会对新老 vnode
节点进行比对,然后将根据比较结果进行最小单位地修改视图。这也许会造成弹出层内容区域的组件没有重新渲染,例如 #8931。当这类问题出现时,pg电子平台的解决方案是给 vnode
加上一个不相同的 key,
使用 html 片段
this.$alert'这是 html 片段', 'html 片段', { dangerouslyusehtmlstring: true });message
属性虽然支持传入 html 片段,但是在网站上动态渲染任意 html 是非常危险的,因为容易导致 xss 攻击。因此在dangerouslyusehtmlstring
打开的情况下,请确保message
的内容是可信的,永远不要将用户提交的内容赋值给message
属性。
¶区分取消与关闭
有些场景下,点击取消按钮与点击关闭按钮有着不同的含义。
默认情况下,当用户触发取消(点击取消按钮)和触发关闭(点击关闭按钮或遮罩层、按下 esc 键)时,promise 的 reject 回调和callback回调的参数均为 'cancel'。
如果将distinguishcancelandclose属性设置为 true,则上述两种行为的参数分别为 'cancel' 和 'close'。
this.$confirm'检测到未保存的内容,是否在离开页面前保存修改?', '确认信息', { distinguishcancelandclose: true, confirmbuttontext: '保存', cancelbuttontext: '放弃修改' }) .then) => { this.$message{ type: 'info', message: '保存修改' }); }) .catchaction => { this.$message{ type: 'info', message: action === 'cancel' ? '放弃保存并离开页面' : '停留在当前页面' }) });
居中布局
内容支持居中布局center
设置为 true
即可开启居中布局
全局方法
如果你完整引入了 element,它会为 vue.prototype 添加如下全局方法:$msgbox, $alert, $confirm 和 $prompt。因此在 vue instance 中可以采用本页面中的方式调用 messagebox
。调用参数为:
$msgboxoptions)
$alertmessage, title, options)
或 $alertmessage, options)
$confirmmessage, title, options)
或 $confirmmessage, options)
$promptmessage, title, options)
或 $promptmessage, options)
单独引用
如果单独引入 messagebox
:
import { messagebox } from 'element-ui';
那么对应于上述四个全局方法的调用方法依次为:messagebox, messagebox.alert, messagebox.confirm 和 messagebox.prompt,调用参数与全局方法相同。
然后就是一堆选项配置
notification 通知
悬浮出现在页面角落,显示全局的通知提醒消息。
notification 组件提供通知功能,element 注册了$notify
方法,接收一个options
字面量参数,在最简单的情况下,你可以设置title
字段和message
字段,用于设置通知的标题和正文。
默认情况下,经过一段时间后 notification 组件会自动关闭,但是通过设置duration
,可以控制关闭的时间间隔,特别的是,如果设置为0
,则不会自动关闭。
注意:duration
接收一个number
,单位为毫秒,默认为4500
。
this.$notify{ title: '标题名称', message: h'i', { style: 'color: teal'}, '这是提示文案这是提示文案 这是提示文案这是提示文案这是提示文案这是提示文案这是提示文案这 是提示文案') });
带有倾向性
带有 icon,常用来显示「成功、警告、消息、错误」类的系统消息
success, warning, info, error。通过type字段来设置 我们也为 notification 的各种 type 注册了方法,可以在不传入type字段的情况下像open3和open4那样直接调用。 this.$notify{ title: '成功', message: '这是一条成功的提示消息', type: 'success' }); this.$notify.info{ title: '消息', message: '这是一条消息的提示消息' });
自定义弹出位置
可以让 notification 从屏幕四角中的任意一角弹出
使用position属性定义 notification 的弹出位置,支持四个选项:top-right、top-left、bottom-right、bottom-left,默认为top-right。
带有偏移
让 notification 偏移一些位置
notification 提供设置偏移量的功能,通过设置 offset 字段,可以使弹出的消息距屏幕边缘偏移一段距离。注意在同一时刻,所有的 notification 实例应当具有一个相同的偏移量。
使用html片段
this.$notify{ title: 'html 片段', dangerouslyusehtmlstring: true, message: '这是 html 片段' });
隐藏关闭按钮
可以不显示关闭按钮,将showclose
属性设置为false
即可隐藏关闭按钮。
全局方法
element 为 vue.prototype
添加了全局方法 $notify
。因此在 vue instance 中可以采用本页面中的方式调用 notification。
单独引用
单独引入 notification:
import { notification } from 'element-ui';
此时调用方法为 notificationoptions)
。我们也为每个 type 定义了各自的方法,如 notification.successoptions)
。并且可以调用 notification.closeall)
手动关闭所有实例。
nmenu 导航菜单
导航菜单默认为垂直模式,通过mode
属性可以使导航菜单变更为水平模式。mode=”horizontal”
另外,在菜单中通过submenu
组件可以生成二级菜单。
background-color:设置菜单的背景色
text-color:菜单的文字颜色
active-text-color:当前激活菜单的文字颜色
@select=“handleselect” 绑定在el-menu上
default-active="activeindex" class="el-menu-demo" mode="horizontal" @select="handleselect"> "1">处理中心 "2"> "title">我的工作台 "2-1">选项1 "2-2">选项2 "2-3">选项3 "2-4"> "title">选项4 "2-4-1">选项1 "2-4-2">选项2 "2-4-3">选项3 "3" disabled>消息中心 "4">
侧栏垂直菜单,可内嵌子菜单。
通过el-menu-item-group
组件可以实现菜单进行分组,分组名可以通过title
属性直接设定,也可以通过具名 slot 来设定。
class="tac"> "12"> 默认颜色
menu default-active="2" class="el-menu-vertical-demo" @open="handleopen" @close="handleclose"> "1"> "title"> class="el-icon-location"> 导航一 "title">分组一 "1-1">选项1 "1-2">选项2 "分组2"> "1-3">选项3 "1-4"> "title">选项4 "1-4-1">选项1 "2"> class="el-icon-menu"> "title">导航二 "3" disabled> class="el-icon-document"> "title">导航三 "4"> class="el-icon-setting"> "title">导航四 "12"> 自定义颜色
menu default-active="2" class="el-menu-vertical-demo" @open="handleopen" @close="handleclose" background-color="#545c64" text-color="#fff" active-text-color="#ffd04b"> "1"> "title"> class="el-icon-location"> 导航一 "title">分组一 "1-1">选项1 "1-2">选项2 "分组2"> "1-3">选项3 "1-4"> "title">选项4 "1-4-1">选项1 "2"> class="el-icon-menu"> "title">导航二 "3" disabled> class="el-icon-document"> "title">导航三 "4"> class="el-icon-setting"> "title">导航四
菜单折叠
"iscollapse" style="margin-bottom: 20px;"> "false">展开 "true">收起 default-active="1-4-1" class="el-menu-vertical-demo" @open="handleopen" @close="handleclose" :collapse="iscollapse">
多tab页面
基础用法:tabs 组件提供了选项卡功能,默认选中第一个标签页,你也可以通过 value
属性来指定当前选中的标签页。
"activename" @tab-click="handleclick"> "用户管理" name="first">用户管理 "配置管理" name="second">配置管理 "角色管理" name="third">角色管理 "定时任务补偿" name="fourth">定时任务补偿
选项卡样式
"activename" type="card" @tab-click="handleclick"> "用户管理" name="first">用户管理 "配置管理" name="second">配置管理 "角色管理" name="third">角色管理 "定时任务补偿" name="fourth">定时任务补偿
卡片化标签页
"border-card"> "用户管理">用户管理 "配置管理">配置管理 "角色管理">角色管理 "定时任务补偿">定时任务补偿
位置标签
标签一共有四个方向的设置 tabposition="left|right|top|bottom"
"tabposition" style="margin-bottom: 30px;"> "top">top "right">right "bottom">bottom "left">left "tabposition" style="height: 200px;"> "用户管理">用户管理 "配置管理">配置管理 "角色管理">角色管理 "定时任务补偿">定时任务补偿
自定义tab
"border-card"> "label">class="el-icon-date"> 我的行程 我的行程 "消息中心">消息中心 "角色管理">角色管理 "定时任务补偿">定时任务补偿
以上就是小编对于elementui学习笔记问题和相关问题的解答了,elementui学习笔记的问题希望对你有用!
免责声明:本站所有文章内容,图片,视频等均是来源于用户投稿和互联网及文摘转载整编而成,不代表本站观点,不承担相关法律责任。其著作权各归其原作者或其出版社所有。如发现本站有涉嫌抄袭侵权/违法违规的内容,侵犯到您的权益,请在线联系站长,一经查实,本站将立刻删除。 本文链接:https://www.andon8.com/470620.html