Input 输入框

用于接收用户键盘输入值。

受控组件,需要声明 modelValue 属性

基础用法

show code

输入框状态

可以为组件添加 disabled、readonly 标签,渲染不同的状态样式。

禁用 和 只读 状态下输入框不响应任何事件。

show code

插槽

使用 prepend 和 append 插槽可以在输入框前后插入内容。

.com
.com
.com
¥
¥
¥
show code

可清空

为组件添加 clearable 属性,在用户输入字符后显示可清空值的按钮。

show code

API

属性

AttributeTypeDefaultDescription
modelValuestring''输入值
placeholderstring''占位文本
readonlybooleanfalse是否只读
disabledbooleanfalse是否禁用
clearablebooleanfalse展示清空按钮

事件

EventTypeDescription
update:modelValue(value: string) => void监听 modelValue 值变化
on-focus(value: string) => void监听输入框聚焦状态
on-blur(value: string) => void监听输入框失焦状态
on-clear() => void监听设置 clearable 时的清空行为

插槽

SlotDescription
prepend放置在输入框之前的插槽
append放置在输入框之后的插槽