# Input 输入框

WARNING

Input 为受控组件,它总会显示 Vue 绑定值。

通常情况下,应当处理 input 事件,并更新组件的绑定值(或使用v-model)。否则,输入框内显示的值将不会改变。

不支持 v-model 修饰符。

Input Attributes

参数 说明 类型 可选值 默认值
type 类型 String text,textarea 和其他 原生 input 的 type 值 text
value / v-model 绑定值 String / Number
maxlength 原生属性,最大输入长度 Number
minlength 原生属性,最小输入长度 Number
placeholder 输入框占位文本 String
clearable 是否可清空 Boolean false
password 是否显示切换密码图标 Boolean false
rows 输入框行数,只对 type="textarea" 有效 Number 2
name 原生属性 String
readonly 原生属性,是否只读 Boolean false
max 原生属性,设置最大值
min 原生属性,设置最小值
step 原生属性,设置输入字段的合法数字间隔
label 输入框关联的label文字 String

Input Slots

name 说明
prepend 输入框前置内容,只对 type="text" 有效
append 输入框后置内容,只对 type="text" 有效

Input Events

事件名称 说明 回调参数
blur 在 Input 失去焦点时触发 (value: String | Number)
focus 在 Input 获得焦点时触发 (value: String | Number)
change 在 Input 改变时触发 (value: String | Number)
input 在 Input 输入时触发 (value: String | Number)
clear 在点击由 clearable 属性生成的清空按钮时触发
keyup 在 Input 输入键盘弹起时触发 (value: String | Number)
keydown 在 Input 输入键盘按下时触发 (value: String | Number)