Search 搜索框
WebH5
移动端搜索栏。胶囊底、左搜索图标、右侧清空按钮,聚焦时滑出「取消」。
何时使用
列表页/商城顶部搜索入口,尤其移动端 H5。
何时不使用
桌面端复杂筛选表单用 Input + Button 组合。
Props
| 名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
modelValue | string | "\"\"" | 绑定值(v-model) |
placeholder | string | "搜索(取 locale 文案 search.placeholder)" | 占位文本 |
showAction | boolean | true | 聚焦时右侧显示「取消」文字按钮 |
round | boolean | true | 全圆角胶囊;false 为普通圆角 |
disabled | boolean | false | 禁用 |
Events
| 名称 | 载荷 | 说明 |
|---|---|---|
update:modelValue | string | 输入、清空或取消时触发 |
search | string | 回车或点击搜索图标时触发 |
cancel | void | 点击「取消」时触发(同时清空并 blur) |
clear | void | 点击清空按钮时触发 |
示例
基础
示例加载中…
直角且无取消按钮
示例加载中…
三个事件分别回显
示例加载中…
Playground
加载中…
跨端版本
该组件同时提供 uni-app / uni-app X 实现(H5 / 微信小程序 / App),API 可能略有差异,见 uni-app 端 Search 文档(含手机预览)。