Input 输入框
WebH5
单行输入框。支持前后缀插槽、可清空、字数计数与错误态,聚焦时主色边框加柔和外发光。
何时使用
单行文本录入:用户名、搜索关键词、邮箱等。
何时不使用
多行长文本用 Textarea;从固定选项中选值用 Select。
Props
| 名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
modelValue | string | "" | 绑定值,配合 v-model 使用 |
type | string:'text' | 'password' | 'number' | "text" | 原生 type 属性 |
placeholder | string | "" | 占位文本 |
size | string:'sm' | 'md' | 'lg' | "md" | 尺寸;移动端建议 md 或 lg(触摸目标 ≥ 36px) |
disabled | boolean | false | 禁用(灰底) |
readonly | boolean | false | 只读 |
clearable | boolean | false | 可清空;有值且聚焦/hover 时显示清空按钮 |
maxlength | number | null | 最大输入长度,传入后显示 已输/上限 计数 |
error | boolean | false | 错误态,红色边框 |
Events
| 名称 | 载荷 | 说明 |
|---|---|---|
update:modelValue | string | 输入时同步绑定值 |
change | string | 失焦或回车时值发生变化才触发 |
focus | FocusEvent | 聚焦时触发 |
blur | FocusEvent | 失焦时触发 |
clear | void | 点击清空按钮时触发,同时 update:modelValue 为空串 |
Slots
| 名称 | 说明 |
|---|---|
prefix | 输入框内左侧内容(如搜索图标) |
suffix | 输入框内右侧内容(如状态图标) |
示例
基础用法
示例加载中…
尺寸
示例加载中…
密码框
示例加载中…
前后缀插槽
示例加载中…
清空与字数限制
示例加载中…
错误、只读、禁用
示例加载中…
数字输入
示例加载中…
事件监听
示例加载中…
Playground
加载中…
text
md
跨端版本
该组件同时提供 uni-app / uni-app X 实现(H5 / 微信小程序 / App),API 可能略有差异,见 uni-app 端 Input 文档(含手机预览)。