Skip to content

Input 输入框

通过鼠标或键盘输入内容

基础用法

禁用状态

通过 disabled 属性指定是否禁用 input 组件

一键清空

使用 clearable 属性即可得到一个可一键清空的输入框

密码框

设置 type 为 password 可得到一个密码框

使用 show-password 属性即可得到一个可切换显示隐藏的密码框

带图标的输入框

在输入框上添加前缀或后缀图标。

尺寸

使用 size 属性改变输入框大小。 除了默认大小外,还有另外两个选项:smalllarge

文本域

用于多行输入。 添加 type="textarea" 属性来将 input 元素转换为原生的 ``textarea` 元素。

文本域高度可通过 rows 属性控制

输入长度限制

使用 maxlength , 来控制输入内容的最大字数。

允许你通过设置 show-word-limit 到 true 来显示剩余字数。

自定义状态

使用 status 为 Input 添加状态,可选 error 或者 warning

Input API

Attributes

属性名说明类型默认值
type类型text textarea passwordtext
model-value / v-model绑定值string / number--
minlength原生属性,最小输入长度string / number--
maxlength原生属性,最大输入长度string / number--
placeholder输入框占位文本string--
disabled是否禁用booleanfalse
clearable是否显示清除按钮,只有当 type 不是 textarea时生效booleanfalse
size输入框尺寸,只在 type 不为 'textarea' 时有效small default largedefault
show-password是否显示切换密码图标booleanfalse
rows输入框行数,仅 type 为 'textarea' 时有效number2
show-word-limit是否显示统计字数, 只在 type 为 'text' 或 'textarea' 的时候生效booleanfalse
autocomplete原生 autocomplete 属性stringoff
name原生 name 属性string--
min原生属性,设置最小值----
max原生属性,设置最大值----
step原生属性,设置输入字段的合法数字间隔----
readonly原生属性,,是否只读booleanfalse

Events

事件名说明类型
blur当选择器的输入框失去焦点时触发Function
focus当选择器的输入框获得焦点时触发Function
change仅当 modelValue 改变时,当输入框失去焦点或用户按Enter时触发Function
clear在点击由 clearable 属性生成的清空按钮时触发Function

Slots

插槽名说明
prefix输入框头部内容,只对非 type="textarea" 有效
suffix输入框尾部内容,只对非 type="textarea" 有效

基于 MIT 许可发布