Skip to content

Input 输入框

用于接受键盘键入字符。

基础用法

使用v-model设置输入框绑定值。否则输入框不会响应输入事件。

输入框祈祷中...

使用 disabled禁用输入框。

可清空

使用 clearable设置输入框可以一键清空。

附带图标

使用 prefix-icon设置输入框前缀图标。

使用 suffix-icon设置输入框后缀图标。

如果你需要在点击图标后输入框聚焦的效果,请指定输入框的id。

限制输入长度

使用 min-lengthmax-length限制输入框的输入长度。

使用 show-word-limit你可以直观地看到当前绑定值的长度。

类型

使用 type 可以切换输入框类型

不同的尺寸

使用 size指定输入框大小, 需要注意的是, 该属性控制输入框的最大高度以及字体大小。

校验函数

使用 check-func属性可以指定输入框的校验函数, 该函数会在输入框失焦后触发.

ts
interface CheckFunc {
    (val: string): boolean,

    (val: string, alert?: (alertText?: string, alertIcon?: string) => void): boolean
}
interface CheckFunc {
    (val: string): boolean,

    (val: string, alert?: (alertText?: string, alertIcon?: string) => void): boolean
}

第二个参数可选, 该参数作用为简化输入框的alert。缺点是该参数只会在输入框失去焦点后触发,你也可以通过调用input.exposes.alert函数来提示 一些信息,该函数如何调用完全取决于你。

复合型输入框

输入框框提供 prefix-slotsuffix-slot两个槽,用于设置输入框前后的附加元素

Input API

Input Props

属性名说明可选值默认值
type输入框类型'text' | 'password' | 'email'text
modelValue输入框的绑定值'String' | 'Number'---
placeholder输入框占位符String---
maxLength输入框绑定值最大长度'String' |'Number'---
minLength输入框绑定值最下长度'String' |'Number'---
id输入框idString---
autofocus输入框是否会自动聚焦Boleanfalse
disabled输入框是否被禁用Boleanfalse
readonly输入框是否只读Boleanfalse
clearable输入框是否可以被清空Boleanfalse
size输入框大小'small' | 'normal' | 'large'normal
showWordLimit展示输入框绑定值长度Boleanfalse
showPassword展示密码切换图标Boleanfalse
prefixIcon输入框前缀图标String---
suffixIcon输入框后缀图标String---
checkFunc输入框绑定值校验函数 '(val:string) => boolean' | '(value: string, alert?: (alertText?: string, alertIcon?: string) => void) => boolean'---

Input Events

事件名说明类型
clear输入框被清空是触发() => void
input输入框正在输入时触发(value: string ) => void
change输入框绑定值变化时触发,注意和input事件区分(value: string ) => void
blur输入框失去焦点时触发(evt: FocusEvent) => void
focus输入框获取焦点时触发(evt: FocusEvent) => void

Input Slots

名称说明
prefixSlot输入框前缀元素
suffixSlot输入框后缀元素

Input Exposes

属性名说明类型
isLegal输入框绑定值是否合法Boolean
alert用于提示一些信息 '(val:string) => boolean' |'(value: string, alert?: (alertText?: string, alertIcon?: string) => void) => boolean'
showAlert用于显示alert() => void
hiddenAlert用于隐藏alert() => void
toggleAlert用于显示 / 隐藏 alert() => void
clear清空输入框() => void
focus输入框获取焦点() => void
blur输入框失去焦点() => void
select选择输入框内容() => void

源代码

组件

贡献者

Released under the MIT License.