输入框 Input

基本表单组件,并在原生控件基础上进行了功能扩展,可以组合使用

基本使用

输入框的基本使用

卡片输入框

设置属性 cardtrue 即可开启卡片模式的输入框

TIP

Select、Cascader、TreeSelect、DatePicker 组件的输入框基于 Input,因此这些组件都有 card 属性向 Input 内部传递

可清空

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

禁用

设置属性 disabledtrue 即可禁用此输入框

密码

设置属性 show-passwordtrue 即可开启带密码样式的输入框

图标

设置属性prefix-icon suffix-icon 即可添加图标

复合型输入框 alpha.38

可以在输入框中前置或后置添加一个元素,通常是按钮和选择器

通过 slot 来指定在 Input 前置或者后置的内容

过滤器

添加 formatter 函数即可自定义过滤器

尺寸

设置 size 属性即可调整输入框的大小

文本域

用于输入多行文本信息,通过将 type 属性的值指定为 textarea

可自适应文本高度的文本域

通过设置 autosize 属性可以使得文本域的高度能够根据文本内容自动进行调整,并且 autosize 还可以设定为一个对象,指定最小行数和最大行数

字数统计

设置 max-length 可以限制最大字数,配合 show-word-limit 可以显示字数统计

API

Attributes

属性名描述类型默认值
v-model绑定值string | number-
type类型text | textareatext
size尺寸(只对type:text生效)small | default | largenormal
show-password是否显示切换密码图标booleanfalse
disabled禁用booleanfalse
prefix-icon输入框头部图标string-
suffix-icon输入框尾部图标string-
formatter输入框过滤器(val:string) => string-
maxlength最大输入长度string | number-
show-word-limit是否显示统计字数boolean-
autosize自适应内容高度,只对 type="textarea" 有效,可传入对象,如: { minRows: 2, maxRows: 6 }object | booleanfalse
autocomplete原生属性,自动补全on | offoff
name原生属性string-
form原生属性string-
readonly原生属性,是否只读booleanfalse
autofocus原生属性,自动获取焦点booleanfalse
card输入框卡片模式boolean-

Events

name描述函数类型
blur在 Input 失去焦点时触发(event: Event) => void
focus在 Input 获得焦点时触发(event: Event) => void
change仅在输入框失去焦点或用户按下回车时触发(value: string | number) => void
input在 Input 值改变时触发(value: string | number) => void
clear在 Input 清空时触发() => void

Slots

name描述scoped
prefix-icon输入框头部图标,只对非 type="textarea" 有效-
suffix-icon输入框尾部图标,只对非 type="textarea" 有效-
prepend alpha.38输入框前置内容,只对非 type="textarea" 有效-
append alpha.38输入框后置内容,只对非 type="textarea" 有效-

最后更新时间: