Skip to content

Input 输入框

用于文本输入的基础组件,支持尺寸、前后缀、清空、字数统计、密码显示、左右扩展等能力,可搭配表单验证使用。

基础用法

使用 v-model 双向绑定输入值。

当前:(空)

尺寸

通过 size 设置组件尺寸:smmdlgxl

禁用

通过 disabled 使输入框不可编辑。

可清空

设置 clearable 显示清除按钮(有值、未禁用、type=text 时显示)。

密码显隐

设置 showPassword 在后缀显示切换密码可见性的图标。

字数统计

设置 maxlengthshowCount 展示“已输入/上限”。超过上限会标红提示。

0 / 20

前缀/后缀

通过 prefix/suffix 文本或 prefixIconfont/suffixIconfont 图标展示。也支持 prefixIcon/suffixIcon 传入组件。

https://
.com

前后置内容

使用 #prepend/#append 插槽或 prepend/append 文本属性扩展两侧内容。

https://
.io

圆角与宽度

使用 round 启用更圆的外观;通过 width 设置宽度(传数字字符串,单位 px)。

事件

常用事件:inputclearfocusblurchangekeydownkeyup

属性

属性名类型默认值说明
v-modelstring''输入值
placeholderstring请输入内容占位提示
disabledbooleanfalse是否禁用
maxlengthnumber/string''最大输入长度
sizestringsm尺寸:sm/md/lg/xl
roundbooleanfalse是否圆角外观
typestringtext原生 input 类型,支持 text/password 等(配合 showPassword 更友好)
showPasswordbooleanfalse是否显示密码可见切换图标,仅在 type='password' 或同等场景有意义
clearablebooleanfalse是否可一键清除(仅 type='text' 且有值时显示)
showCountbooleanfalse是否展示“已输入/上限”计数
widthstring100%组件宽度,传数字字符串如 320 表示 320px
prefix/suffixstring''前缀/后缀文本
prefixIcon/suffixIconComponent/string''前缀/后缀图标组件或名称(组件优先)
prefixIconfont/suffixIconfontstring''使用 iconfont 类名(例如 icon-search1
prepend/appendstring''左右两侧扩展的纯文本内容(插槽优先)
validateEventbooleantrue是否在表单中触发表单校验(依赖表单组件)

事件

事件名回调参数说明
input(value, evt)输入变化时触发(支持中文输入法结束后触发)
clear()点击清空按钮后触发
focus/blur(evt)聚焦/失焦时触发
mouseenter/mouseleave(evt)鼠标进入/离开时触发
compositionstart/update/end(evt)输入法合成相关事件
change(evt)原生 change 事件
keydown/keyup(evt)键盘按下/抬起时触发

插槽

插槽名说明
prepend左侧附加内容区域
append右侧附加内容区域