Skip to content

Input 输入框

输入框允许用户在 UI 中输入文本, 它们通常出现在表单和对话框中

基础用法

禁用状态

限制输入格式

前缀和后缀

带标签的

在输入框上添加前缀或后缀标签,需要自己写一点点代码

文本域

尺寸

API

Input props

属性名说明类型默认值
model-value / v-model输入框内容string/ number
placeholder占位符string请输入
clearable可以点击清除图标删除内容booleanfalse
disabled是否禁用booleanfalse
readonly是否只读booleanfalse
inputStyleinput 元素或 textarea 元素的 styleCSSProperties
autofocus是否自动获取焦点booleanfalse
maxlength最大输入长度number
size大小large default smalldefault
type类型原生 input 类型 | textareastringtext
allowInput校验当前的输入是否合法,如果返回 false 输入框便不会响应此次的输入Function(value: string) => boolean

Input Events

属性名说明类型
change仅当 modelValue 改变时,当输入框失去焦点或用户按Enter时触发Function
inputInput 值改变时触发Function
blur当选择器的输入框失去焦点时触发Function
focus当选择器的输入框获得焦点时触发Function

Input defineExpose

名称说明类型
blur使 input 失去焦点Function
focus使 input 获取焦点Function
clear清除 input 值Function
refHTML元素 input 或 textareaobject

Slots

插槽名说明
prefix设置前置标签,只对非 type="textarea" 有效
suffix设置后置标签,只对非 type="textarea" 有效