Skip to content

Input 输入框

表单中的输入框组件。

基础用法

可以通过 v-model 双向绑定输入框的值,通过 placeholder 设置占位提示文字。

输入框状态

readonlydisabled属性用来设置只读、禁用。

类型

type 属性用来设置 input 类型,默认为text, 包括text, digit, number, textarea, search, password

对齐

input-align 属性用来设置对齐方式,默认为right, 包括left, center, right

显示图标

输入框左右两侧支持设置图标。

显示清空图标

clearable 属性用来设置输入框是否显示清空图标(只在输入框不为空并且聚焦时显示)。

多行文本

自定义格式化函数

formatter

插槽

属性

属性名类型默认值说明
modelValuestring | number--输入框的值
namestring--输入框的名称
typestringtext输入框的类型
placeholderstring--输入框的提示文字
editablebooleantrue输入框是否可编辑
readonlybooleanfalse输入框是否只读
disabledbooleanfalse输入框是否禁用
clearablebooleanfalse输入框是否显示清空图标
input-alignstringleft输入框对齐方式
left-iconstring--输入框左侧图标名
right-iconstring--输入框右侧图标名
formatter(value: string | number) => string | number--格式化函数
maxlengthnumber--输入框的最大长度
borderbooleanfalse输入框是否显示边框

事件

事件名类型说明
update:modelValueEventEmitter<string | nunmber>值变化事件
clearEventEmitter<void>清空输入框值事件
blurEventEmitter<MouseEvent>输入框失去焦点事件
focusEventEmitter<MouseEvent>输入框聚焦事件
inputEventEmitter<InputEvent>输入框输入事件
click-left-iconEventEmitter<MouseEvent>输入框左侧图标点击事件
click-right-iconEventEmitter<MouseEvent>输入框右侧图标点击事件

插槽

名称说明
left输入框左侧内容
right输入框右侧内容

组件实例

名称类型说明
blur() => void输入框失去焦点
focus() => void输入框聚焦

CSS 变量

名称默认值说明
--fm-input-sizevar(--fm-font-size)--
--fm-input-colorvar(--fm-text-color)--
--fm-input-padding10px 16px--
--fm-input-border-colorvar(--fm-gray-2)--