Skip to content

Input 输入框

通过鼠标或键盘输入字符

WARNING

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

在正常情况下,input 的输入事件应该被正常响应。 它的处理程序应该更新组件的绑定值 (或使用 v-model)。 否则,输入框的值将不会改变。

不支持 v-model 修饰符。

基础用法

禁用状态

一键清空

密码框

带图标的输入框

带有图标标记输入类型

API

属性

属性名说明类型默认值
type类型^[string]'text' | ... native input typestext
model-value / v-model绑定值^[string] / ^[number]
maxlength最大输入长度^[string] / ^[number]
minlength原生属性,最小输入长度^[number]
placeholder输入框占位文本^[string]
clearable是否显示清除按钮,只有当 type 不是 textarea时生效^[boolean]false
show-password是否显示切换密码图标^[boolean]false
disabled是否禁用^[boolean]false
prefix-icon自定义前缀图标^[string] / ^[Component]
suffix-icon自定义后缀图标^[string] / ^[Component]
readonly原生 readonly 属性,是否只读^[boolean]false
autofocus原生属性,自动获取焦点^[boolean]false

事件

事件名说明类型
blur当选择器的输入框失去焦点时触发^[Function](event: FocusEvent) => void
focus当选择器的输入框获得焦点时触发^[Function](event: FocusEvent) => void
change仅当 modelValue 改变时,当输入框失去焦点或用户按Enter时触发^[Function](value: string | number) => void
input在 Input 值改变时触发^[Function](value: string | number) => void
clear在点击由 clearable 属性生成的清空按钮时触发^[Function]() => void

插槽

插槽名说明
prefix输入框头部内容
suffix输入框尾部内容

对外暴露的方法

名称说明类型
blur使 input 失去焦点^[Function]() => void
clear清除 input 值^[Function]() => void
focus使 input 获取焦点^[Function]() => void
inputInput HTML 元素^[object]Ref<HTMLInputElement>

Released under the MIT License.