vant/docs/markdown/zh-CN/field.md

Field 输入框

input或textarea的输入框。

使用指南

import { Field } from 'vant';

Vue.use(Field);

代码演示

基础用法

通过 v-model 绑定输入框的值

<van-cell-group>
  <van-field v-model="value" placeholder="请输入用户名"></van-field>
</van-cell-group>

自定义类型

根据type属性定义不同类型的输入框

<van-cell-group>
  <van-field
    v-model="username"
    label="用户名"
    icon="clear"
    placeholder="请输入用户名"
    required
    @click-icon="username = ''"
  >
  </van-field>

  <van-field
    v-model="password"
    type="password"
    label="密码"
    placeholder="请输入密码"
    required>
  </van-field>
</van-cell-group>

禁用输入框

<van-cell-group>
  <van-field value="输入框已禁用" label="用户名" disabled></van-field>
</van-cell-group>

错误提示

<van-cell-group>
  <van-field label="用户名" placeholder="请输入用户名" error></van-field>
</van-cell-group>

高度自适应

对于 textarea，可以通过autosize属性设置高度自适应

<van-cell-group>
  <van-field
    v-model="message"
    label="留言"
    type="textarea"
    placeholder="请输入留言"
    rows="1"
    autosize
  >
  </van-field>
</van-cell-group>

API

Filed 默认支持 Input 标签所有的原生属性，比如 maxlength、placeholder、readonly、autofocus 等

参数	说明	类型	默认值	可选值
type	输入框类型	String	text	number email textarea tel datetime date password url
value	输入框的值	String	-	-
label	输入框标签	String	-	-
disabled	是否禁用输入框	Boolean	false	-
error	输入框是否有错误	Boolean	false	-
autosize	高度自适应(仅支持textarea)	Boolean	false	-
icon	输入框尾部图标	String	-	Icon 组件支持的类型

Event

Filed 默认支持 Input 标签所有的原生事件，比如 keypress、keyup 等

事件名称	说明	回调参数
focus	输入框聚焦时触发	-
blur	输入框失焦时触发	-
click-icon	点击尾部图标时触发	-

Slot

name	描述
icon	自定义icon