Skip to content

自动补全输入框

该组件是低代码平台中用于带智能建议的文本输入场景,基于 Element Plus 的 <el-autocomplete> 封装,支持动态获取输入建议,并深度集成表单容器(<el-form>)的数据绑定与校验体系。

基础属性

属性类型说明
是否支持一键清空 clearableboolean显示“×”按钮,点击清空内容(默认开启)
前缀图标 prefixIconstring'ep:search',显示在输入框左侧
后缀图标 suffixIconstring'ep:arrow-down',显示在输入框右侧
是否显示统计字数 showWordLimitboolean需配合最大长度使用
最小长度 minlengthnumber输入内容最小字符数(整数)
最大长度 maxlengthnumber输入内容最大字符数(整数)
文本格式 textPatternenum预设格式(如手机号、邮箱等),用于自动校验
输入建议函数 fetchSuggestionsfunction$args[0] 为当前输入值,需返回 { value } 格式的建议项数组(异步支持)
是否自动获取焦点 autofocusboolean页面加载时自动聚焦
输入提示文本 placeholderstring占位提示文字
表单项基础配置包含标签宽度、布局控制等通用表单项设置(来自 formItemBaseDefine

高级属性

属性类型说明
表单项高级配置包含字段名(prop)、标签文本(label)等核心绑定配置(来自 formItemAdvDefine

事件

事件触发时机说明
change值改变时对应 Element Plus 的 change 事件