mirror of
https://gitee.com/vant-contrib/vant.git
synced 2025-04-06 03:57:59 +08:00
135 lines
2.7 KiB
Markdown
135 lines
2.7 KiB
Markdown
<style>
|
||
.demo-field {
|
||
padding-bottom: 30px;
|
||
}
|
||
</style>
|
||
|
||
<script>
|
||
export default {
|
||
data() {
|
||
return {
|
||
value: '',
|
||
password: '',
|
||
username: 'zhangmin',
|
||
message: ''
|
||
};
|
||
}
|
||
};
|
||
</script>
|
||
|
||
## Field 输入框
|
||
|
||
表单中`input`或`textarea`的输入框。
|
||
|
||
### 使用指南
|
||
``` javascript
|
||
import { Field } from 'vant';
|
||
|
||
Vue.component(Field.name, Field);
|
||
```
|
||
|
||
### 代码演示
|
||
|
||
#### 基础用法
|
||
通过 v-model 绑定输入框的值
|
||
|
||
:::demo 基础用法
|
||
```html
|
||
<van-cell-group>
|
||
<van-field v-model="value" placeholder="请输入用户名"></van-field>
|
||
</van-cell-group>
|
||
```
|
||
:::
|
||
|
||
#### 自定义类型
|
||
根据`type`属性定义不同类型的输入框
|
||
|
||
:::demo 自定义类型
|
||
```html
|
||
<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>
|
||
```
|
||
:::
|
||
|
||
#### 禁用输入框
|
||
|
||
:::demo 禁用输入框
|
||
```html
|
||
<van-cell-group>
|
||
<van-field value="输入框已禁用" label="用户名" disabled></van-field>
|
||
</van-cell-group>
|
||
```
|
||
:::
|
||
|
||
#### 错误提示
|
||
|
||
:::demo 错误提示
|
||
```html
|
||
<van-cell-group>
|
||
<van-field label="用户名" placeholder="请输入用户名" error></van-field>
|
||
</van-cell-group>
|
||
```
|
||
:::
|
||
|
||
#### 高度自适应
|
||
对于 textarea，可以通过`autosize`属性设置高度自适应
|
||
|
||
:::demo 高度自适应
|
||
```html
|
||
<van-cell-group>
|
||
<van-field
|
||
v-model="message"
|
||
label="留言"
|
||
type="textarea"
|
||
placeholder="请输入留言"
|
||
rows="1"
|
||
autosize
|
||
>
|
||
</van-field>
|
||
</van-cell-group>
|
||
```
|
||
:::
|
||
|
||
### API
|
||
|
||
| 参数 | 说明 | 类型 | 默认值 | 可选值 |
|
||
|-----------|-----------|-----------|-------------|-------------|
|
||
| type | 输入框类型 | `String` | `text` | `number` `email` <br> `textarea` `tel` <br> `datetime` `date` <br> `password` `url` |
|
||
| value | 输入框的值 | `String` | - | - |
|
||
| label | 输入框标签 | `String` | - | - |
|
||
| disabled | 是否禁用输入框 | `Boolean` | `false` | - |
|
||
| error | 输入框是否有错误 | `Boolean` | `false` | - |
|
||
| autosize | 高度自适应(仅支持textarea) | `Boolean` | `false` | - |
|
||
| icon | 输入框尾部图标 | `String` | - | Icon 组件支持的类型 |
|
||
|
||
### Event
|
||
|
||
| 事件名称 | 说明 | 回调参数 |
|
||
|-----------|-----------|-----------|
|
||
| focus | 输入框聚焦时触发 | - |
|
||
| blur | 输入框失焦时触发 | - |
|
||
| click-icon | 点击尾部图标时触发 | - |
|
||
|
||
### Slot
|
||
|
||
| name | 描述 |
|
||
|-----------|-----------|
|
||
| icon | 自定义icon |
|