Input 输入框
输入框允许用户在 UI 中输入文本, 它们通常出现在表单和对话框中
基础用法
禁用状态
限制输入格式
前缀和后缀
带标签的
在输入框上添加前缀或后缀标签,需要自己写一点点代码
文本域
尺寸
API
Input props
| 属性名 | 说明 | 类型 | 默认值 |
|---|---|---|---|
| model-value / v-model | 输入框内容 | string/ number | — |
| placeholder | 占位符 | string | 请输入 |
| clearable | 可以点击清除图标删除内容 | boolean | false |
| disabled | 是否禁用 | boolean | false |
| readonly | 是否只读 | boolean | false |
| inputStyle | input 元素或 textarea 元素的 style | CSSProperties | — |
| autofocus | 是否自动获取焦点 | boolean | false |
| maxlength | 最大输入长度 | number | — |
| size | 大小 | large default small | default |
| type | 类型原生 input 类型 | textarea | string | text |
| allowInput | 校验当前的输入是否合法,如果返回 false 输入框便不会响应此次的输入 | Function(value: string) => boolean | — |
Input Events
| 属性名 | 说明 | 类型 |
|---|---|---|
| change | 仅当 modelValue 改变时,当输入框失去焦点或用户按Enter时触发 | Function |
| input | Input 值改变时触发 | Function |
| blur | 当选择器的输入框失去焦点时触发 | Function |
| focus | 当选择器的输入框获得焦点时触发 | Function |
Input defineExpose
| 名称 | 说明 | 类型 |
|---|---|---|
| blur | 使 input 失去焦点 | Function |
| focus | 使 input 获取焦点 | Function |
| clear | 清除 input 值 | Function |
| ref | HTML元素 input 或 textarea | object |
Slots
| 插槽名 | 说明 |
|---|---|
| prefix | 设置前置标签,只对非 type="textarea" 有效 |
| suffix | 设置后置标签,只对非 type="textarea" 有效 |
