跳到正文

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 ​

属性类型默认值说明
modelValuestring''输入框当前值(v-model 绑定)
placeholderstring—占位提示文案,无输入时显示
type'text' | 'password' | 'number''text'原生输入类型:text 文本 / password 密码 / number 数字,默认 'text'
disabledbooleanfalse是否禁用输入
maxlengthnumber—最大可输入字符数,超出后无法继续输入
prefixIconstring—前缀图标名称,格式 "category/icon-name",如 "search"
clearablebooleanfalse是否显示清除按钮(有输入内容时右侧出现)。
默认清除图标为 xmark/light,搜索场景可传 clear-icon="search/xmark"。
clearIconstring'xmark/light'清除按钮图标名称,默认 "xmark/light"
errorbooleanfalse是否处于错误状态;为 true 时边框变红并显示错误图标
errorMessagestring''错误提示文案;传入时显示在输入框下方
errorIconstring'circle/bang'错误图标名称,默认 "circle/bang"
readonlybooleanfalse是否只读;只读时背景置灰但文字仍可选中复制
variant'default' | 'search' | 'filled' | 'ghost' | 'underline''default'输入框风格变体
- 'default': 毛玻璃面(#F5F5F5 20% 半透明填充 + 同色细描边 + backdrop blur,设计稿 inputs/onlight)+ 胶囊圆角,适用于表单输入(默认)
- 'search': 毛玻璃面 + 聚焦光环,适用于搜索框
- 'filled': 毛玻璃面(旧搜索风格)
- 'ghost': 完全透明 + 聚焦时底部细线,极简风格
- 'underline': 无背景 + 仅底部一条线,最极简
pillbooleanfalse椭圆(pill)档位:true 时输入框锁定胶囊形态规格(border-radius 9999px、
整体高度 36px、垂直内边距 8px),优先级高于主题 componentsShape;
默认 false(圆角走主题 --uikit-input-radius,纯椭圆)

Events ​

事件名参数说明
update:modelValuevalue: string输入内容变化时触发,负载为最新输入值,供 v-model 双向同步
inputevent: Event输入事件,负载为原生 input 事件对象(与 update:modelValue 同时触发)
focusevent: FocusEvent输入框获得焦点时触发,负载为原生 focus 事件
blurevent: FocusEvent输入框失去焦点时触发,负载为原生 blur 事件
submitvalue: string按下回车(非 Shift+Enter)时触发,负载为当前输入值,常用于搜索/提交