Input 输入框
该组件是低代码平台中用于单行文本、密码或文本域输入的基础表单项,基于 Element Plus 的 <el-input> 封装,并深度集成表单容器(<el-form>)的校验、布局与数据绑定体系。
基础属性
| 属性 | 类型 | 说明 |
|---|---|---|
是否支持一键清空 clearable | boolean | 显示“×”按钮,点击清空内容(默认开启) |
前缀图标 prefixIcon | string | 如 'ep:search',显示在输入框左侧 |
后缀图标 suffixIcon | string | 如 'ep:calendar',显示在输入框右侧 |
输入类型 type | enum | 可选:text(文本)、password(密码)、textarea(文本域) |
文本域高度是否自适应 autosize | boolean | 仅当输入类型为“文本域”时生效 |
文本域行数 rows | number | 固定行数,仅当类型为“文本域”且未启用自适应高度时生效 |
文本域最小行数 minRows | number | 仅当类型为“文本域”且启用自适应高度时生效 |
文本域最大行数 maxRows | number | 仅当类型为“文本域”且启用自适应高度时生效 |
是否显示统计字数 showWordLimit | boolean | 需配合最大长度使用 |
最小长度 minlength | number | 输入内容最小字符数(整数) |
最大长度 maxlength | number | 输入内容最大字符数(整数) |
文本格式 textPattern | enum | 预设格式(如手机号、邮箱等),用于自动校验 |
是否自动获取焦点 autofocus | boolean | 页面加载时自动聚焦 |
输入提示文本 placeholder | string | 占位提示文字 |
| 表单项基础配置 | — | 包含标签宽度、布局控制等通用表单项设置(来自 formItemBaseDefine) |
高级属性
| 属性 | 类型 | 说明 |
|---|---|---|
| 表单项高级配置 | — | 包含字段名(prop)、标签文本(label)等核心绑定配置(来自 formItemAdvDefine) |
事件
| 事件 | 触发时机 | 说明 |
|---|---|---|
change | 值改变时 | 对应 Element Plus 的 change 事件 |
