搜索框 basic-search

2026年7月20日大约 3 分钟

搜索框 `basic-search`

输入关键字 → 联动 / 筛选其它组件。

类型串：basic-search　默认尺寸：[260, 36]　分类：控件

实时预览

下面渲染的是真实组件（与编辑器 / 运行时同源）。修改右侧「样式参数」，左侧预览实时更新；点击底部「全页面查看」可放大。

属性

下表为本组件特有的属性；position / size / opacity / background / border / 联动选中 / 筛选等通用参数见组件手册总览。

basic

属性	名称	类型	默认	说明
`placeholder`	占位提示	`string`	`请输入搜索内容`
`default-value`	默认值	`string`	—
`fuzzy-search`	模糊搜索	`boolean`	`false`	开启后联动值为 `$contains` 模糊匹配
`pinyin-search`	拼音搜索	`boolean`	`false`	开启后可用全拼或首字母匹配中文（如 `gz` / `guangzhou` 命中「广州」）；联动值为 `$pinyinContains`
`text-arrangement`	文本排列	`select(radioGroup)`	`horizontal`	可选：`horizontal` / `vertical`
`show-icon`	显示搜索图标	`boolean`	`true`
`clearable`	可清空	`boolean`	`true`
`realtime`	实时搜索	`boolean`	`false`
`realtime-min-length`	最小触发字数	`number(min=0)`	`1`
`realtime-debounce`	防抖	`number(min=0,unit=ms)`	`300`
`show-button`	显示搜索按钮	`boolean`	`true`
`button-text`	按钮文本	`string`	`搜索`

input

属性	名称	类型	默认
`input-bg`	背景颜色	`color`	`#1f2733`
`input-text-color`	文字颜色	`color`	`#ffffff`
`input-font-size`	字号	`number(unit=px,min=0)`	`14`
`input-border-color`	边框颜色	`color`	`#3a4252`
`input-hover-border-color`	悬浮边框色	`color`	`#4f5a6e`
`input-focus-border-color`	聚焦边框色	`color`	`#2f7bff`
`input-border-width`	边框宽度	`number(unit=px,min=0)`	`1`
`input-radius`	圆角半径	`number(unit=px,min=0)`	`4`

clear

属性	名称	类型	默认
`clear-color`	默认颜色	`color`	`#cccccc`
`clear-hover-color`	悬浮颜色	`color`	`#ffffff`
`clear-size`	按钮大小	`number(unit=px,min=8)`	`16`
`clear-offset`	按钮偏移	`number(unit=px,min=0)`	`5`

button

属性	名称	类型	默认	说明
`button-bg`	背景颜色	`color(gradient)`	`#2f7bff`
`button-text-color`	文字颜色	`color`	`#ffffff`

数据绑定

字段槽	类型 / 约束	说明
`linkage-field`	`field(recommend=string,min=0,max=1)`	联动字段

事件

触发器

触发器在预览 / 播放态生效（编辑态点击 = 选中组件）。写在本组件 options.interactions 的 groups[].trigger 里。

触发器	名称	触发时机	payload（供动作公式 `{:字段}` 取值）
`click`	点击	点击本组件时触发	无
`mouseEnter`	鼠标移入	指针移入组件时触发	无
`mouseLeave`	鼠标移出	指针移出组件时触发	无
`appear`	入场	组件出现时触发（配合进场动画）	无
`disappear`	离场	组件消失时触发（配合退场动画）	无
`receiveBehaviorEvent`	接收行为事件	收到 `sendBehaviorEvent` 动作或宿主 `ctx.emit` 投递的事件时触发（按 `eventName` 匹配）	发送方携带的 data

动作

触发器命中后执行的动作。本组件既可发起动作（配在自己的交互里），也可作为其它组件动作的目标。

动作	名称	说明
`changeOption`	修改设置	把本组件（或其它组件）的某个属性改为静态值 / 公式动态值
`switchState`	切换状态	切到多状态里的某个状态（`state:""` 回默认态）
`appear / disappear`	进 / 退场动画	对目标 `opacity` 做 0↔100 插值的显隐动画

完整动作清单（switchScreen / switchWindow / openUrl / sendBehaviorEvent / transfer / executeScript / requestApi 等）与持久化写法见事件交互。

示例

{
  "type": "basic-search",
  "uid": "w_basic_search",
  "options": {
    "position": [40, 40],
    "size": [260, 36],
    "linkage-field": [["conn_demo", "tbl_demo", "字段名"]]
  }
}

绑定三元组 [连接uid, 表uid, 字段uid] 指向工程 connections 里的真实字段，见数据系统。

延伸阅读：组件手册总览 · 数据系统 · 事件交互。