# 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) |