结束了vue的基础学习,现在进一步学习组件
Element-Plus部分学习目标:
Element Plus | 1、查阅官方文档指南 |
2、学习常用组件的使用方法 |
3、Table、Pagination、Form |
4、Input、Input Number、Switch、Select、Date Picker、Button |
5、Message、MessageBox、Notification |
查阅官方文档: 快速开始 | Element Plus
具体内容官网讲解的很清楚,这里只根据学习目标,以及以后可能常用的部分做总结,学习理解的话还是建议大家直接去看官方文档。
Table 表格组件 Table 表格 | Element Plus
常用属性
属性 | 类型 | 可选值/说明 | 默认值 |
---|
data | Array | 表格数据数组 | [] |
border | Boolean | true/false (是否显示边框) | false |
stripe | Boolean | true/false (是否显示斑马纹) | false |
height | String/Number | 固定高度,如 '400px' | - |
max-height | String/Number | 最大高度 | - |
size | String | medium / small / mini (表格尺寸) | - |
fit | Boolean | true/false (列宽是否自撑开) | true |
show-header | Boolean | true/false (是否显示表头) | true |
highlight-current-row | Boolean | true/false (是否高亮当前行) | false |
Table-column 属性
属性 | 类型 | 可选值/说明 | 默认值 |
---|
prop | String | 对应列内容的字段名 | - |
label | String | 显示的标题 | - |
width | String/Number | 列宽度 | - |
min-width | String/Number | 最小列宽 | - |
fixed | String/Boolean | true/false/'left'/'right' (固定列) | - |
sortable | Boolean/String | true/false/'custom' (是否可排序) | false |
align | String | left/center/right (对齐方式) | left |
header-align | String | left/center/right (表头对齐方式) | - |
Pagination 分页组件 Pagination 分页 | Element Plus
常用属性
属性 | 类型 | 可选值/说明 | 默认值 |
---|
current-page | Number | 当前页码 | 1 |
page-size | Number | 每页显示条目数 | 10 |
total | Number | 总条目数 | - |
page-sizes | Array | [10, 20, 30, 40, 50, 100] (每页显示个数选择器的选项设置) | [10, 20, 30, 50, 100] |
layout | String | 组件布局,可用值: sizes, prev, pager, next, jumper, ->, total, slot | 'prev, pager, next, jumper, ->, total' |
background | Boolean | true/false (是否为分页按钮添加背景色) | false |
small | Boolean | true/false (是否使用小型分页样式) | false |
Form 表单组件
常用属性
属性 | 类型 | 可选值/说明 | 默认值 |
---|
model | Object | 表单数据对象 | - |
rules | Object | 表单验证规则 | - |
label-position | String | right/left/top (表单域标签的位置) | right |
label-width | String/Number | 表单域标签的宽度 | - |
size | String | medium / small / mini (控制表单内组件尺寸) | - |
disabled | Boolean | true/false (是否禁用表单中所有组件) | false |
inline | Boolean | true/false (行内表单模式) | false |
show-message | Boolean | true/false (是否显示校验错误信息) | true |
Form-item 属性
属性 | 类型 | 可选值/说明 | 默认值 |
---|
prop | String | 表单域 model 字段 | - |
label | String | 标签文本 | - |
label-width | String/Number | 标签宽度 | - |
required | Boolean | true/false (是否必填) | false |
rules | Object/Array | 表单验证规则 | - |
size | String | medium / small / mini (控制组件尺寸) | - |
Input 输入框
常用属性
属性 | 类型 | 可选值/说明 | 默认值 |
---|
type | String | text / textarea / password / number / email / url | text |
size | String | medium / small / mini (输入框尺寸) | - |
maxlength | Number | 最大输入长度 | - |
minlength | Number | 最小输入长度 | - |
show-word-limit | Boolean | true/false (是否显示输入字数统计) | false |
clearable | Boolean | true/false (是否可清空) | false |
show-password | Boolean | true/false (是否显示切换密码图标) | false |
disabled | Boolean | true/false (是否禁用) | false |
prefix-icon | String | 输入框头部图标类名 | - |
suffix-icon | String | 输入框尾部图标类名 | - |
Select 选择器
常用属性
属性 | 类型 | 可选值/说明 | 默认值 |
---|
multiple | Boolean | true/false (是否多选) | false |
disabled | Boolean | true/false (是否禁用) | false |
clearable | Boolean | true/false (是否可以清空选项) | false |
filterable | Boolean | true/false (是否可搜索) | false |
remote | Boolean | true/false (是否为远程搜索) | false |
loading | Boolean | true/false (是否正在从远程获取数据) | false |
size | String | medium / small / mini (选择器尺寸) | - |
collapse-tags | Boolean | true/false (多选时是否将选中值按文字的形式展示) | false |
Option 属性
属性 | 类型 | 可选值/说明 | 默认值 |
---|
value | String/Number/Boolean/Object | 选项的值 | - |
label | String/Number | 选项的标签 | - |
disabled | Boolean | true/false (是否禁用该选项) | false |
Date Picker 日期选择器
常用属性
属性 | 类型 | 可选值/说明 | 默认值 |
---|
type | String | year/month/date/dates/datetime/datetimerange/daterange/monthrange | date |
format | String | 显示在输入框中的格式,如 'yyyy-MM-dd' | - |
value-format | String | 绑定值的格式 | - |
placeholder | String | 占位文本 | - |
range-separator | String | 选择范围时的分隔符 | '-' |
start-placeholder | String | 范围选择时开始日期的占位内容 | - |
end-placeholder | String | 范围选择时结束日期的占位内容 | - |
disabled | Boolean | true/false (是否禁用) | false |
clearable | Boolean | true/false (是否显示清除按钮) | true |
size | String | medium / small / mini (输入框尺寸) | - |
Button 按钮
常用属性
属性 | 类型 | 可选值/说明 | 默认值 |
---|
type | String | primary / success / warning / danger / info / text | - |
size | String | medium / small / mini (按钮尺寸) | - |
plain | Boolean | true/false (是否朴素按钮) | false |
round | Boolean | true/false (是否圆角按钮) | false |
circle | Boolean | true/false (是否圆形按钮) | false |
loading | Boolean | true/false (是否加载中状态) | false |
disabled | Boolean | true/false (是否禁用状态) | false |
icon | String | 图标类名 | - |
autofocus | Boolean | true/false (是否默认聚焦) | false |
native-type | String | button / submit / reset (原生 type 属性) | button |
Message 消息提示
配置选项
属性 | 类型 | 可选值/说明 | 默认值 |
---|
message | String | 消息文字 | - |
type | String | success / warning / info / error | info |
duration | Number | 显示时间(毫秒),设为 0 则不会自动关闭 | 3000 |
showClose | Boolean | true/false (是否显示关闭按钮) | false |
center | Boolean | true/false (文字是否居中) | false |
offset | Number | 距离窗口顶部的偏移量 | 20 |
grouping | Boolean | true/false (合并内容相同的消息) | false |
MessageBox 弹框
配置选项
属性 | 类型 | 可选值/说明 | 默认值 |
---|
title | String | 标题 | '提示' |
message | String | 消息正文内容 | - |
type | String | success / warning / info / error | - |
confirmButtonText | String | 确认按钮文本 | '确定' |
cancelButtonText | String | 取消按钮文本 | '取消' |
showCancelButton | Boolean | true/false (是否显示取消按钮) | false |
showConfirmButton | Boolean | true/false (是否显示确认按钮) | true |
closeOnClickModal | Boolean | true/false (是否可通过点击遮罩关闭) | true |
closeOnPressEscape | Boolean | true/false (是否可通过 ESC 键关闭) | true |
center | Boolean | true/false (内容是否居中) | false |
Notification 通知
配置选项
属性 | 类型 | 可选值/说明 | 默认值 |
---|
title | String | 标题 | - |
message | String | 消息文字 | - |
type | String | success / warning / info / error | - |
duration | Number | 显示时间(毫秒),设为 0 则不会自动关闭 | 4500 |
position | String | top-right / top-left / bottom-right / bottom-left | top-right |
offset | Number | 距离窗口顶部的偏移量 | 0 |
showClose | Boolean | true/false (是否显示关闭按钮) | true |