Search 搜索框
uni-appH5微信小程序App
基于 uni-app 原生输入能力的跨端搜索框。
何时使用
列表页/商城顶部搜索入口,尤其移动端 H5。
何时不使用
桌面端复杂筛选表单用 Input + Button 组合。
本文档为 uni-app 端组件契约;Web 端同名组件 API 可能略有差异,请以对应包文档为准。下方手机预览实时运行 uni-app H5 演示。
Props
| 名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
modelValue | string | "" | 绑定值(v-model) |
placeholder | string | "搜索" | 占位文本 |
showAction | boolean | false | 聚焦时右侧显示「取消」文字按钮 |
round | boolean | true | 全圆角胶囊;false 为普通圆角 |
disabled | boolean | false | 禁用 |
Events
| 名称 | 载荷 | 说明 |
|---|---|---|
update:modelValue | string | 输入、清空或取消时触发 |
search | string | 回车或点击搜索图标时触发 |
clear | void | 点击清空按钮时触发 |
cancel | void | 点击「取消」时触发(同时清空并 blur) |
示例
基础用法
vue
<Search v-model="kw" placeholder="搜索组件" />带取消按钮
vue
<Search v-model="kw" placeholder="搜索订单 / 商品" show-action />方形与禁用
vue
<Search v-model="kw" :round="false" placeholder="方形搜索框" />
<Search disabled placeholder="禁用状态" style="margin-top:10px" />