Skip to content

Field 输入框

继承van-field所有属性

用户可以在文本框内输入或编辑文字。

基础用法

自定义类型

禁用输入框

显示图标

必填星号

自动展示星号

错误提示

插入按钮

格式化输入内容

高度自适应

显示字数统计

输入框内容对齐

输入框文本位置

API

Attributes

属性名说明类型默认值
type类型string 'text' | 'textarea' | 'password' | 'button' | 'checkbox' | 'file' | 'number' | 'radio' | ... 等原生 input 类型text
model-value / v-model绑定值string / number
maxlength同原生 maxlength 属性string / number
minlength原生属性,最小输入长度string / number
show-word-limit是否显示统计字数, 只在 type 为 'text' 或 'textarea' 的时候生效booleanfalse
placeholder输入框占位文本string
clearable是否显示清除按钮,只有当 type 不是 textarea时生效booleanfalse
formatter指定输入值的格式。(只有当 type 是"text"时才能工作)Function (value: string | number) => string
disabled是否禁用booleanfalse
size输入框尺寸,只在 type 不为 'textarea' 时有效enum 'large' | 'default' | 'small'
autosizetextarea 高度是否自适应,仅 type 为 'textarea' 时生效。 可以接受一个对象,比如: { minRows: 2, maxRows: 6 }boolean / object { minRows?: number, maxRows?: number }false
autocomplete原生 autocomplete 属性stringoff
name等价于原生 input name 属性string
readonly原生 readonly 属性,是否只读booleanfalse
max原生 max 属性,设置最大值
min原生属性,设置最小值

Events

事件名说明类型
blur当选择器的输入框失去焦点时触发Function (event: FocusEvent) => void
focus当选择器的输入框获得焦点时触发Function (event: FocusEvent) => void
clear在点击由 clearable 属性生成的清空按钮时触发Function () => void