自动补全输入框
该组件是低代码平台中用于带智能建议的文本输入场景,基于 Element Plus 的 <el-autocomplete> 封装,支持动态获取输入建议,并深度集成表单容器(<el-form>)的数据绑定与校验体系。
基础属性
| 属性 | 类型 | 说明 |
|---|---|---|
是否支持一键清空 clearable | boolean | 显示“×”按钮,点击清空内容(默认开启) |
前缀图标 prefixIcon | string | 如 'ep:search',显示在输入框左侧 |
后缀图标 suffixIcon | string | 如 'ep:arrow-down',显示在输入框右侧 |
是否显示统计字数 showWordLimit | boolean | 需配合最大长度使用 |
最小长度 minlength | number | 输入内容最小字符数(整数) |
最大长度 maxlength | number | 输入内容最大字符数(整数) |
文本格式 textPattern | enum | 预设格式(如手机号、邮箱等),用于自动校验 |
输入建议函数 fetchSuggestions | function | $args[0] 为当前输入值,需返回 { value } 格式的建议项数组(异步支持) |
是否自动获取焦点 autofocus | boolean | 页面加载时自动聚焦 |
输入提示文本 placeholder | string | 占位提示文字 |
| 表单项基础配置 | — | 包含标签宽度、布局控制等通用表单项设置(来自 formItemBaseDefine) |
高级属性
| 属性 | 类型 | 说明 |
|---|---|---|
| 表单项高级配置 | — | 包含字段名(prop)、标签文本(label)等核心绑定配置(来自 formItemAdvDefine) |
事件
| 事件 | 触发时机 | 说明 |
|---|---|---|
change | 值改变时 | 对应 Element Plus 的 change 事件 |
