Element框架之Form

1.Radio 单选框
基础用法
在这里插入图片描述
要使用 Radio 组件,只需要设置v-model绑定变量,选中意味着变量的值为相应 Radio label属性的值,label可以是String、Number或Boolean。




禁用状态
单选框不可用的状态。
在这里插入图片描述
只要在el-radio元素中设置disabled属性即可,它接受一个Boolean,true为禁用。




单选框组
适用于在多个互斥的选项中选择的场景
Element框架之Form_第1张图片




按钮样式
按钮样式的单选组合。
Element框架之Form_第2张图片




带有边框
Element框架之Form_第3张图片




2.Checkbox 多选框
基础用法
单独使用可以表示两种状态之间的切换,写在标签中的内容为 checkbox 按钮后的介绍。
Element框架之Form_第4张图片



禁用状态
多选框不可用状态
Element框架之Form_第5张图片



多选框组
适用于多个勾选框绑定到同一个数组的情景,通过是否勾选来表示这一组选项中选中的项。
Element框架之Form_第6张图片




indeterminate 状态
indeterminate 属性用以表示 checkbox 的不确定状态,一般用于实现全选的效果
在这里插入图片描述



可选项目数量的限制
使用 min 和 max 属性能够限制可以被勾选的项目的数量。
在这里插入图片描述



3.Input 输入框
Element框架之Form_第7张图片
基础用法
在这里插入图片描述




禁用状态
Element框架之Form_第8张图片





可清空
Element框架之Form_第9张图片





密码框
Element框架之Form_第10张图片




带icon的输入框
Element框架之Form_第11张图片

属性方式:
slot 方式:

文本域
Element框架之Form_第12张图片





可自适应文本高度的文本域
Element框架之Form_第13张图片



复合型输入框
Element框架之Form_第14张图片

尺寸
Element框架之Form_第15张图片

带输入建议
Element框架之Form_第16张图片


  
    
激活即列出输入建议
输入后匹配输入建议

自定义模板
Element框架之Form_第17张图片


  
  
  





远程搜索
在这里插入图片描述




输入长度限制
Element框架之Form_第18张图片



4.InputNumber 计数器
基础用法
Element框架之Form_第19张图片



禁用状态
Element框架之Form_第20张图片



严格步数
Element框架之Form_第21张图片



精度
Element框架之Form_第22张图片



尺寸
额外提供了 medium、small、mini 三种尺寸的数字输入框
在这里插入图片描述



按钮位置
Element框架之Form_第23张图片



5.Select 选择器
基础用法
Element框架之Form_第24张图片
v-model的值为当前被选中的el-option的 value 属性值




有禁用选项(在el-option中,设定disabled值为 true,即可禁用该选项)
Element框架之Form_第25张图片




可清空单选
Element框架之Form_第26张图片




基础多选
Element框架之Form_第27张图片
为el-select设置multiple属性即可启用多选,此时v-model的值为当前选中值所组成的数组。默认情况下选中值会以 Tag 的形式展现,你也可以设置collapse-tags属性将它们合并为一段文字。




自定义模板
Element框架之Form_第28张图片
将自定义的 HTML 模板插入el-option的 slot 中即可。





分组显示
Element框架之Form_第29张图片
使用el-option-group对备选项进行分组,它的label属性为分组名




可搜索(可以利用搜索功能快速查找选项)
Element框架之Form_第30张图片
为el-select添加filterable属性即可启用搜索功能。默认情况下,Select 会找出所有label属性包含输入值的选项。如果希望使用其他的搜索逻辑,可以通过传入一个filter-method来实现。filter-method为一个Function,它会在输入值发生变化时调用,参数为当前输入值。




远程搜索
在这里插入图片描述
为了启用远程搜索,需要将filterable和remote设置为true,同时传入一个remote-method。remote-method为一个Function,它会在输入值发生变化时调用,参数为当前输入值。需要注意的是,如果el-option是通过v-for指令渲染出来的,此时需要为el-option添加key属性,且其值需具有唯一性,比如此例中的item.value。




6.Cascader 级联选择器
基础用法(有两种触发子菜单的方式)
Element框架之Form_第31张图片
只需为 Cascader 的options属性指定选项数组即可渲染出一个级联选择器。通过props.expandTrigger可以定义展开子级菜单的触发方式。

默认 click 触发子菜单
hover 触发子菜单

禁用选项(通过在数据源中设置 disabled 字段来声明该选项是禁用的)
Element框架之Form_第32张图片
本例中,options指定的数组中的第一个元素含有disabled: true键值对,因此是禁用的。在默认情况下,Cascader 会检查数据中每一项的disabled字段是否为true,如果你的数据中表示禁用含义的字段名不为disabled,可以通过props.disabled属性来指定(详见下方 API 表格)。当然,value、label和children这三个字段名也可以通过同样的方式指定。
Element框架之Form_第33张图片
可清空(通过 clearable 设置输入框可清空)
在这里插入图片描述




仅显示最后一级(可以仅在输入框中显示选中项最后一级的标签,而不是选中项所在的完整路径。)
Element框架之Form_第34张图片
动态加载(当选中某一级时,动态加载该级下的选项。)
Element框架之Form_第35张图片
通过lazy开启动态加载,并通过lazyload来设置加载数据源的方法。lazyload方法有两个参数,第一个参数node为当前点击的节点,第二个resolve为数据加载完成的回调(必须调用)。为了更准确的显示节点的状态,还可以对节点数据添加是否为叶子节点的标志位 (默认字段为leaf,可通过props.leaf修改),否则会简单的以有无子节点来判断是否为叶子节点。




级联面板(级联面板是级联选择器的核心组件,与级联选择器一样,有单选、多选、动态加载等多种功能)
Element框架之Form_第36张图片
和级联选择器一样,通过options来指定选项,也可通过props来设置多选、动态加载等功能,具体详情见下方API表格。




7.Switch 开关
基本用法
在这里插入图片描述
绑定v-model到一个Boolean类型的变量。可以使用active-color属性与inactive-color属性来设置开关的背景色。





文字描述
Element框架之Form_第37张图片
使用active-text属性与inactive-text属性来设置开关的文字描述。







扩展的 value 类型

Element框架之Form_第38张图片
设置active-value和inactive-value属性,接受Boolean, String或Number类型的值。


  
  



禁用状态
Element框架之Form_第39张图片
设置disabled属性,接受一个Boolean,设置true即可禁用。






8.Slider 滑块(通过拖动滑块在一个固定区间内进行选择)
基础用法(在拖动滑块时,显示当前值)
Element框架之Form_第40张图片




离散值(选项可以是离散的)
Element框架之Form_第41张图片
改变step的值可以改变步长,通过设置show-stops属性可以显示间断点





带有输入框(通过输入框设置精确数值)
在这里插入图片描述
设置show-input属性会在右侧显示一个输入框




范围选择(支持选择某一数值范围)
在这里插入图片描述
设置range即可开启范围选择,此时绑定值是一个数组,其元素分别为最小边界值和最大边界值




竖向模式
Element框架之Form_第42张图片
设置vertical可使 Slider 变成竖向模式,此时必须设置高度height属性




展示标记
在这里插入图片描述
设置 marks 属性可以展示标记




9.TimePicker 时间选择器(用于选择或输入日期)
固定时间点(提供几个固定的时间点供用户选择)
Element框架之Form_第43张图片
使用 el-time-select 标签,分别通过star、end和step指定可选的起始时间、结束时间和步长






任意时间点(可以选择任意时间)
Element框架之Form_第44张图片
使用 el-time-picker 标签,通过selectableRange限制可选时间范围。提供了两种交互方式:默认情况下通过鼠标滚轮进行选择,打开arrow-control属性则通过界面上的箭头进行选择。





规定时间范围
Element框架之Form_第45张图片




任意时间范围
Element框架之Form_第46张图片
添加is-range属性即可选择时间范围,同样支持arrow-control属性。




10.DatePicker 日期选择器(用于选择或输入日期)
选择日(以「日」为基本单位,基础的日期选择控件)
Element框架之Form_第47张图片
基本单位由type属性指定。快捷选项需配置picker-options对象中的shortcuts,禁用日期通过 disabledDate 设置,传入函数




其他日期单位 (通过扩展基础的日期选择,可以选择周、月、年或多个日期)
Element框架之Form_第48张图片

多个日期

选择日期范围(可在一个选择器中便捷地选择一个时间范围)
Element框架之Form_第49张图片
在选择日期范围时,默认情况下左右面板会联动。如果希望两个面板各自独立切换当前月份,可以使用unlink-panels属性解除联动。




选择月份范围
Element框架之Form_第50张图片
在选择月份范围时,默认情况下左右面板会联动。如果希望两个面板各自独立切换当前年份,可以使用unlink-panels属性解除联动。




日期格式
Element框架之Form_第51张图片




默认显示日期
Element框架之Form_第52张图片
选择日期范围时,默认情况下,起始日期和结束日期的时间部分均为当天的 0 点 0 分 0 秒。通过default-time可以分别指定二者的具体时刻。default-time接受一个数组,其中的值为形如12:00:00的字符串,第一个值控制起始日期的时刻,第二个值控制结束日期的时刻。




11.DateTimePicker 日期时间选择器(在同一个选择器里选择日期和时间)
日期和时间点
Element框架之Form_第53张图片
通过设置type属性为datetime,即可在同一个选择器里同时进行日期和时间的选择。快捷选项的使用方法与 Date Picker 相同。




日期和时间范围
Element框架之Form_第54张图片
设置type为datetimerange即可选择日期和时间范围




默认的起始与结束时刻
Element框架之Form_第55张图片
使用datetimerange进行范围选择时,在日期选择面板中选定起始与结束的日期,默认会使用该日期的00:00:00作为起始与结束的时刻;通过选项default-time可以控制选中起始与结束日期时所使用的具体时刻。default-time接受一个数组,数组每项值为字符串,形如12:00:00,其中第一项控制起始日期的具体时刻,第二项控制结束日期的具体时刻。




12.Upload 上传
¶ 点击上传
Element框架之Form_第56张图片
通过 slot 你可以传入自定义的上传按钮类型和文字提示。可通过设置limit和on-exceed来限制上传文件的个数和定义超出限制时的行为。可通过设置before-remove来阻止文件移除操作。


  点击上传
  
只能上传jpg/png文件,且不超过500kb

¶ 用户头像上传(使用 before-upload 限制用户上传的图片格式和大小)

Element框架之Form_第57张图片


  
  






¶ 文件缩略图(使用 scoped-slot 去设置缩略图模版)





class=“el-upload-list__item-preview”
@click=“handlePictureCardPreview(file)”
>


v-if="!disabled"
class=“el-upload-list__item-delete”
@click=“handleDownload(file)”
>


v-if="!disabled"
class=“el-upload-list__item-delete”
@click=“handleRemove(file)”
>





¶ 照片墙(使用 list-type 属性来设置文件列表的样式)
Element框架之Form_第58张图片


  


  


¶ 图片列表缩略图
Element框架之Form_第59张图片


  点击上传
  
只能上传jpg/png文件,且不超过500kb

¶ 上传文件列表控制(通过 on-change 钩子函数来对列表进行控制)
Element框架之Form_第60张图片


  点击上传
  
只能上传jpg/png文件,且不超过500kb

¶ 拖拽上传
Element框架之Form_第61张图片


  
  
将文件拖到此处,或点击上传
只能上传jpg/png文件,且不超过500kb

¶ 手动上传
Element框架之Form_第62张图片


  选取文件
  上传到服务器
  
只能上传jpg/png文件,且不超过500kb

13.Rate 评分
¶ 基础用法
Element框架之Form_第63张图片
评分默认被分为三个等级,可以利用颜色数组对分数及情感倾向进行分级(默认情况下不区分颜色)。三个等级所对应的颜色用colors属性设置,而它们对应的两个阈值则通过 low-threshold 和 high-threshold 设定。你也可以通过传入颜色对象来自定义分段,键名为分段的界限值,键值为对应的颜色。

默认不区分颜色
区分颜色

¶ 辅助文字(用辅助文字直接地表达对应分数)
在这里插入图片描述
为组件设置 show-text 属性会在右侧显示辅助文字。通过设置 texts 可以为每一个分值指定对应的辅助文字。texts 为一个数组,长度应等于最大值 max。





¶ 其它 icon(当有多层评价时,可以用不同类型的 icon 区分评分层级)
在这里插入图片描述
设置icon-classes属性可以自定义不同分段的图标。若传入数组,共有 3 个元素,为 3 个分段所对应的类名;若传入对象,可自定义分段,键名为分段的界限值,键值为对应的类名。本例还使用void-icon-class指定了未选中时的图标类名。





¶ 只读(只读的评分用来展示分数,允许出现半星)
在这里插入图片描述
为组件设置 disabled 属性表示组件为只读,支持小数分值。此时若设置 show-score,则会在右侧显示目前的分值。可以提供 score-template 作为显示模板,模板为一个包含了 {value} 的字符串,{value} 会被解析为分值。





14.ColorPicker 颜色选择器
¶ 基础用法
Element框架之Form_第64张图片
使用 v-model 与 Vue 实例中的一个变量进行双向绑定,绑定的变量需要是字符串类型。

有默认值
无默认值

¶ 选择透明度
Element框架之Form_第65张图片
ColorPicker 支持普通颜色,也支持带 Alpha 通道的颜色,通过show-alpha属性即可控制是否支持透明度的选择。




¶ 预定义颜色
Element框架之Form_第66张图片
ColorPicker 支持预定义颜色





¶ 不同尺寸
Element框架之Form_第67张图片







15.Transfer 穿梭框
¶ 基础用法
Element框架之Form_第68张图片
Transfer 的数据通过 data 属性传入。数据需要是一个对象数组,每个对象有以下属性:key 为数据的唯一性标识,label 为显示文本,disabled 表示该项数据是否禁止转移。目标列表中的数据项会同步到绑定至 v-model 的变量,值为数据项的 key 所组成的数组。当然,如果希望在初始状态时目标列表不为空,可以像本例一样为 v-model 绑定的变量赋予一个初始值。




¶ 可搜索 (在数据很多的情况下,可以对数据进行搜索和过滤)
Element框架之Form_第69张图片
设置 filterable 为 true 即可开启搜索模式。默认情况下,若数据项的 label 属性包含搜索关键字,则会在搜索结果中显示。你也可以使用 filter-method 定义自己的搜索逻辑。filter-method 接收一个方法,当搜索关键字变化时,会将当前的关键字和每个数据项传给该方法。若方法返回 true,则会在搜索结果中显示对应的数据项。




16.Form 表单
¶ 典型表单 (包括各种表单项,比如输入框、选择器、开关、单选框、多选框等)
Element框架之Form_第70张图片
在 Form 组件中,每一个表单域由一个 Form-Item 组件构成,表单域中可以放置各种类型的表单控件,包括 Input、Select、Checkbox、Radio、Switch、DatePicker、TimePicker


  
    
  
  
    
      
      
    
  
  
    
      
    
    -
    
      
    
  
  
    
  
  
    
      
      
      
      
    
  
  
    
      
      
    
  
  
    
  
  
    立即创建
    取消
  


¶ 行内表单(当垂直方向空间受限且表单较简单时,可以在一行内放置表单)
在这里插入图片描述
设置 inline 属性可以让表单域变为行内的表单域


  
    
  
  
    
      
      
    
  
  
    查询
  


¶ 对齐方式
根据具体目标和制约因素,选择最佳的标签对齐方式。
Element框架之Form_第71张图片
通过设置 label-position 属性可以改变表单域标签的位置,可选值为 top、left,当设为 top 时标签会置于表单域的顶部


  左对齐
  右对齐
  顶部对齐

¶ 表单验证
在防止用户犯错的前提下,尽可能让用户更早地发现并纠正错误。
Element框架之Form_第72张图片
Form 组件提供了表单验证的功能,只需要通过 rules 属性传入约定的验证规则,并将 Form-Item 的 prop 属性设置为需校验的字段名即可。校验规则参见 async-validator


  
    
  
  
    
      
      
    
  
  
    
      
        
      
    
    -
    
      
        
      
    
  
  
    
  
  
    
      
      
      
      
    
  
  
    
      
      
    
  
  
    
  
  
    立即创建
    重置
  


¶ 自定义校验规则
Element框架之Form_第73张图片
本例还使用status-icon属性为输入框添加了表示校验结果的反馈图标。

el-form :model="ruleForm" status-icon :rules="rules" ref="ruleForm" label-width="100px" class="demo-ruleForm">
  
    
  
  
    
  
  
    
  
  
    提交
    重置
  


¶ 动态增减表单项
Element框架之Form_第74张图片


  
    
  
  
    删除
  
  
    提交
    新增域名
    重置
  


¶ 数字类型验证
Element框架之Form_第75张图片
数字类型的验证需要在 v-model 处加上 .number 的修饰符,这是 Vue 自身提供的用于将绑定值转化为 number 类型的修饰符


  
    
  
  
    提交
    重置
  


¶ 表单内组件尺寸控制
Element框架之Form_第76张图片
如果希望某个表单项或某个表单组件的尺寸不同于 Form 上的size属性,直接为这个表单项或表单组件设置自己的size即可。


  
    
  
  
    
      
      
    
  
  
    
      
    
    -
    
      
    
  
  
    
      
      
      
    
  
  
    
      
      
    
  
  
    立即创建
    取消
  



你可能感兴趣的:(Element框架之Form)