Input 输入框
文本输入框组件,支持搜索、密码、填充、幽灵、下划线等形态。
使用方式
组件以 EmInput 为名导出,全局注册后可直接使用:
vue
<template>
<em-input v-model="text" placeholder="请输入内容" />
</template>形态
基础用法
使用建议
| ✅ Do | ❌ Don't |
|---|---|
表单校验失败时设置 error 并给出 error-message | 仅依赖边框变红,不说明错误原因 |
只读信息使用 readonly,禁用操作使用 disabled | 用 disabled 展示需要复制的信息 |
搜索框使用 variant="search" 并配合 prefix-icon | 在普通输入框内手动塞搜索图标 |
密码、手机号等敏感输入设置正确的 type | 所有输入都用 type="text" |
| 占位文案说明输入预期,如「请输入群名称」 | 占位文案与 label 完全重复 |
API
Input API
Props
| 属性 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| modelValue | string | '' | 输入框当前值(v-model 绑定) |
| placeholder | string | — | 占位提示文案,无输入时显示 |
| type | 'text' | 'password' | 'number' | 'text' | 原生输入类型:text 文本 / password 密码 / number 数字,默认 'text' |
| disabled | boolean | false | 是否禁用输入 |
| maxlength | number | — | 最大可输入字符数,超出后无法继续输入 |
| prefixIcon | string | — | 前缀图标名称,格式 "category/icon-name",如 "search" |
| clearable | boolean | false | 是否显示清除按钮(有输入内容时右侧出现)。 默认清除图标为 xmark/light,搜索场景可传 clear-icon="search/xmark"。 |
| clearIcon | string | 'xmark/light' | 清除按钮图标名称,默认 "xmark/light" |
| error | boolean | false | 是否处于错误状态;为 true 时边框变红并显示错误图标 |
| errorMessage | string | '' | 错误提示文案;传入时显示在输入框下方 |
| errorIcon | string | 'circle/bang' | 错误图标名称,默认 "circle/bang" |
| readonly | boolean | false | 是否只读;只读时背景置灰但文字仍可选中复制 |
| variant | 'default' | 'search' | 'filled' | 'ghost' | 'underline' | 'default' | 输入框风格变体 - 'default': 毛玻璃面(#F5F5F5 20% 半透明填充 + 同色细描边 + backdrop blur,设计稿 inputs/onlight)+ 胶囊圆角,适用于表单输入(默认) - 'search': 毛玻璃面 + 聚焦光环,适用于搜索框 - 'filled': 毛玻璃面(旧搜索风格) - 'ghost': 完全透明 + 聚焦时底部细线,极简风格 - 'underline': 无背景 + 仅底部一条线,最极简 |
| pill | boolean | false | 椭圆(pill)档位:true 时输入框锁定胶囊形态规格(border-radius 9999px、 整体高度 36px、垂直内边距 8px),优先级高于主题 componentsShape; 默认 false(圆角走主题 --uikit-input-radius,纯椭圆) |
Events
| 事件名 | 参数 | 说明 |
|---|---|---|
update:modelValue | value: string | 输入内容变化时触发,负载为最新输入值,供 v-model 双向同步 |
input | event: Event | 输入事件,负载为原生 input 事件对象(与 update:modelValue 同时触发) |
focus | event: FocusEvent | 输入框获得焦点时触发,负载为原生 focus 事件 |
blur | event: FocusEvent | 输入框失去焦点时触发,负载为原生 blur 事件 |
submit | value: string | 按下回车(非 Shift+Enter)时触发,负载为当前输入值,常用于搜索/提交 |
