el-form 是 Element Plus 的表单组件,由输入框、单选框、选择器、复选框等组成,用于收集、校验和提交数据。
用途:创建含多个输入字段的表单、实现表单校验、处理表单提交、创建内联表单、调整表单项布局与对齐、实现动态增删表单项。
主要能力:支持内联、垂直、水平标签对齐;基于 async-validator 的内置校验;自定义校验函数;动态增删表单项;统一尺寸控制;ARIA 无障碍支持;内联或 tooltip 错误提示。
使用方式:在 el-form 上通过 :model 绑定数据、:rules 绑定校验规则,el-form-item 通过 prop 关联 model 键以触发校验。表单暴露 validate、validateField、resetFields、scrollToField、clearValidate、fields、getField、setInitialValues 等方法。校验规则支持 required、message、trigger、min、max、len、type、pattern、validator、enum、whitespace、transform、fields 等字段。
适用场景:常规数据录入表单、登录注册、弹窗内表单、带 API 提交的表单、动态字段表单。
限制与注意:prop 必须与 model 键完全一致,否则校验不触发;数字校验需使用 .number 修饰符;阻止回车提交可用 @submit.prevent;嵌套表单项需在嵌套项上设置 label-width。具体版本兼容性与安装方式资料未提供。