组件概述
Search 是搜索组件,为用户提供搜索框、搜索结果展示、界面跳转等功能的完整组件集合。该组件支持用户搜索、群组搜索、消息搜索等功能,并提供了丰富的交互回调接口。
说明:
搜索入口 | 搜索结果 |
![]() | ![]() |
组件集成
Search 组件属于 TUIKit Compose 的一部分,集成 TUIKit Compose 即可获取并使用 Search 组件。集成方法请参考文档 TUIKit Compose 里的集成步骤,完成登录操作。
组件构成
SearchScreen 是 Search 组件的入口组件,对外仅暴露了搜索组件的初始化方法,其他逻辑均封装在 SearchScreen 中。方法名 | 参数 | 描述 |
SearchScreen | modifier: Modifier | Jetpack Compose 中用来设置组件的样式、布局、行为和外观。 |
| onBack: () -> Unit | 点击取消按钮的回调,可选参数。 |
| onContactSelect: (FriendSearchInfo) -> Unit | 点击搜索到的联系人条目时的回调,可选参数。 |
| onGroupSelect: (GroupSearchInfo) -> Unit | 点击搜索到的群组条目时的回调,可选参数。 |
| onConversationSelect: (MessageSearchResultItem) -> Unit | 点击搜索到的会话条目时的回调,可选参数。 |
| onMessageSelect: (MessageInfo) -> Unit | 点击搜索到的消息条目时的回调,可选参数。 |
基础用法
SearchScreen 的搜索结果路由跳转如下:自动路由:在搜索结果界面中,点击更多(More)按钮或聊天记录列表时,组件内部会通过自动完成页面跳转。
自定义路由:当用户点击具体的联系人、群组、会话或消息时,组件会触发相应的回调
onContactSelect/onGroupSelect/onConversationSelect/onMessageSelect,需在回调中实现自定义跳转(例如跳转到您的自定义聊天界面)。如下图所示:

SearchScreen组件可直接初始化使用,示例代码如下:SearchScreen(modifier = Modifier.Companion.fillMaxSize().statusBarsPadding().navigationBarsPadding(),onBack = {// 取消按钮点击响应事件},onContactSelect = {// 联系人点击响应事件},onGroupSelect = {// 群组点击响应事件},onConversationSelect = {// 会话点击响应事件},onMessageSelect = {// 消息点击响应事件})

