输入框 Input
我不说你也知道他是干啥用的。
基本用法
使用 v-model 属性进行双向绑定。
大小
使用 size 属性设置输入框的大小,提供 small、medium、large 三种尺寸。
使用 width 属性设置输入框的宽度。
图标
使用 icon 属性设置输入框的图标。使用 right-icon 属性设置右侧图标。
前后缀
使用 prepend 和 append 插槽自定义输入框的前后缀内容。
清空
添加 clearable 属性,会显示一个按钮,点击可以清空输入框。
密码框
添加 password 属性后,输入框会变为密码类型,并显示一个切换按钮。
字数
使用 maxlength 属性限制输入的字数,添加 word-limit 属性显示字数统计。
默认选中
添加 autofocus 属性,打开页面后,输入框会自动获取焦点。
禁用
添加 disabled 属性,输入框会被禁用。
API
Input 属性
| 属性 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| modelValue (v-model) | string | — | 输入框绑定值 |
| type | string | text | 输入框类型 |
| size | string | medium | 输入框大小 |
| width | string | 240px | 输入框宽度 |
| placeholder | string | — | 输入框提示文案 |
| icon | string | — | 输入框图标 |
| right-icon | string | — | 输入框右侧图标 |
| autofocus | boolean | false | 是否默认聚焦输入框 |
| clearable | boolean | false | 是否显示清除按钮 |
| password | boolean | false | 是否为密码输入框 |
| maxlength | number | — | 输入框字数限制 |
| word-limit | boolean | false | 是否显示字数统计 |
| readonly | boolean | false | 输入框是为只读模式 |
| disabled | boolean | false | 输入框是否禁用 |
Input 事件
| 名称 | 说明 | 类型 |
|---|---|---|
| input | 输入框输入时触发 | (value: String) => value |
| change | 绑定值改变时触发 | (value: String) => value |
| focus | 输入框获得焦点时触发 | (event: FocusEvent) => event |
| blur | 输入框失去焦点时触发 | (event: FocusEvent) => event |
| clear | 点击清除按钮时触发 | () => true |
Input 插槽
| 名称 | 说明 |
|---|---|
| prepend | 自定义输入框前置内容 |
| append | 自定义输入框后置内容 |