Input 输入框
规则
基础示例
密码框
Props 配置示例
整段禁用
尺寸对比(迷你 / 小 / 中)
文本域 + 字数
Events 示例
Props
| 名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| autocomplete | string | 'off' | 原生 autocomplete 属性 |
| autofocus | boolean | false | 页面加载时自动获取焦点 |
| autosize | boolean | | false | 自适应内容高度(仅 textarea) |
| clearable | boolean | — | 是否显示清除按钮(不适用于 textarea) |
| cols | string | number | — | 原生属性(textarea 有效) |
| counter | boolean | false | 是否显示字数统计 |
| disabled | boolean | false | 是否禁用 |
| display-only | boolean | — | 设置文本只读态 |
| display-only-content | string | — | 只读态的文本内容区 |
| form | string | — | 原生属性 |
| hover-expand | boolean | — | 文本域悬浮展开/收起(textarea) |
| input-box-type | 'normal' | 'underline' | normal | 边框模式 |
| label | string | — | 等价于原生 input aria-label |
| mask | boolean | — | 启用掩码功能(disabled/display-only 生效) |
| max | number | — | 原生属性,最大值 |
| maxlength | number | — | 原生属性,最大长度 |
| memory-space | number | 5 | addMemory 最大保存条目数量 |
| min | number | — | 原生属性,最小值 |
| modelValue / v-model | string | number | — | 绑定值 |
| name | string | — | 原生 name 属性 |
| placeholder | string | — | 占位文本 |
| popup-more | boolean | — | 只读态下显示更多按钮 |
| prefix-icon | Component | — | 头部图标 |
| readonly | boolean | false | 原生属性,只读 |
| resize | 'both' | 'horizontal' | 'vertical' | 'none' | — | 控制是否可缩放 |
| rows | string | number | 2 | 行数(textarea) |
| show-password | boolean | false | 是否显示切换密码图标 |
| show-tooltip | boolean | true | 只读状态下超出是否悬浮提示 |
| show-word-limit | boolean | false | 是否显示输入字数统计 |
| size | 'medium' | 'small' | 'mini' | — | 输入框尺寸 |
| step | number | — | 原生属性,合法数字间隔 |
| suffix-icon | Component | — | 尾部图标 |
| tabindex | string | — | 原生 tabindex |
| type | 'text' | 'textarea' | 'password' | InputHTMLAttributes.type | 'text' | 输入框类型 |
| validate-event | boolean | true | 输入时是否触发表单校验 |
Events
| 名称 | 类型 | 说明 |
|---|---|---|
| blur | (event: FocusEvent) => void | 失去焦点触发 |
| change | (value: string | number) => void | 值改变触发 |
| clear | () => void | 点击清空按钮触发 |
| focus | (event: FocusEvent) => void | 获得焦点触发 |
| input | (event: InputEvent) => void | 输入时触发 |


