跳到主要内容

Input 输入框 ​

WebH5

单行输入框。支持前后缀插槽、可清空、字数计数与错误态,聚焦时主色边框加柔和外发光。

何时使用 ​

单行文本录入:用户名、搜索关键词、邮箱等。

何时不使用 ​

多行长文本用 Textarea;从固定选项中选值用 Select。

Props ​

名称类型默认值说明
modelValuestring""绑定值,配合 v-model 使用
typestring:'text' | 'password' | 'number'"text"原生 type 属性
placeholderstring""占位文本
sizestring:'sm' | 'md' | 'lg'"md"尺寸;移动端建议 md 或 lg(触摸目标 ≥ 36px)
disabledbooleanfalse禁用(灰底)
readonlybooleanfalse只读
clearablebooleanfalse可清空;有值且聚焦/hover 时显示清空按钮
maxlengthnumbernull最大输入长度,传入后显示 已输/上限 计数
errorbooleanfalse错误态,红色边框

Events ​

名称载荷说明
update:modelValuestring输入时同步绑定值
changestring失焦或回车时值发生变化才触发
focusFocusEvent聚焦时触发
blurFocusEvent失焦时触发
clearvoid点击清空按钮时触发,同时 update:modelValue 为空串

Slots ​

名称说明
prefix输入框内左侧内容(如搜索图标)
suffix输入框内右侧内容(如状态图标)

示例 ​

基础用法 ​

示例加载中…

尺寸 ​

示例加载中…

密码框 ​

示例加载中…

前后缀插槽 ​

示例加载中…

清空与字数限制 ​

示例加载中…

错误、只读、禁用 ​

示例加载中…

数字输入 ​

示例加载中…

事件监听 ​

示例加载中…

Playground ​

加载中…

跨端版本 ​

该组件同时提供 uni-app / uni-app X 实现(H5 / 微信小程序 / App),API 可能略有差异,见 uni-app 端 Input 文档(含手机预览)。