Search 搜索框
Search 自管搜索 icon、清除 action、fixed.compactControl 可视 surface、44pt 根命中框、returnKeyType="search" 与 accessibilityRole="search"。这些入口不能由 caller 覆盖。
搜索框可见胶囊默认采用系统玻璃,原生不额外染色,随主题与减少透明度设置变化;禁用只淡化前景。输入、清除、提交和 44pt 交互区域保持原有规则。
值模式与提交
<Search defaultValue="初始关键词" onSubmit={submit} />
<Search
value={query}
onChangeText={setQuery}
onSubmitEditing={recordNativeEvent}
onSubmit={submit}
accessibilityLabel="搜索客户"
/>
首次 render 锁定 controlled/uncontrolled mode。非受控 defaultValue 仅初始化一次;受控调用必须同时给 value 与 onChangeText。Search 只维护一个 controller value:输入、清除和 onSubmit 都读取它。
提供 onSubmit 时,搜索 icon 是可点击的“搜索”按钮,点击交付 onSubmit(currentValue);没有 onSubmit 时仍是装饰图标。按键盘搜索时先执行 onSubmitEditing(event),再执行 onSubmit(currentValue)。输入变化和清除都不自动提交,是否发起查询由调用方决定。
当前 value 非空、字段有效可编辑且 controller 能更新时才渲染小型主题色清除按钮;清除调用同一个 onChangeText('') 路径。disabled 或 editable={false} 时搜索按钮不可用,键盘事件也不交付提交。
需要右侧独立搜索按钮时,在 Search 外组合 IconButton variant="glass",并用 onSubmitEditing 处理键盘提交;省略 Search 的 onSubmit 可保留左侧装饰图标。
删除的入口与 ref
不支持 caller leading、trailing、height、returnKeyType、accessibilityRole、role、clearButtonMode 或 enterKeyHint。disabled/editable={false} 会移除清除 handler 并上报 disabled state。
ref 是 TextFieldHandle,只含 focus() / blur();没有原生 clear()。无可见 label 时提供 accessibilityLabel。
搜索框的可见高度复用 fixed.compactControl,右侧独立图标按钮使用 IconButton surfaceSize={fixed.compactControl} 并垂直居中。输入内的清除按钮使用 control.xs 表面与 icon.xxs 图标,采用中性主题底色;保持 44pt 命中区域,不叠加玻璃材质。