输入区(MessageInput)
输入区:MessageInput 是 IDL 定义的跨端 UI 组件,props / events / behaviors 在各平台语义一致。本页给出契约属性、事件、渲染行为、数据源与 iOS 端绑定/示例。
契约属性(props)
| 属性 | 类型 | 必填 | 说明 |
|---|---|---|---|
draft | string | 是 | 草稿文本 |
disabled | bool | 是 | 是否禁用输入 |
muted | bool | 是 | 是否被禁言(禁言时禁用发送并提示) |
mentionCandidates | UserProfile[] | 否 | @ 候选成员列表 |
maxLength | int | 否 | 最大输入长度(默认 5000) |
事件
| 事件 | 参数 | 说明 |
|---|---|---|
send | text,extras? | 输入区发送文本 |
typing | bool | 输入状态变化(true / false) |
pickImage | — | 选择图片 |
pickFile | — | 选择文件 |
startRecord | — | 宿主回调(参数见 IDL 事件定义) |
pickLocation | — | 选择位置 |
draftChanged | draft | 草稿变化 |
渲染行为
- 输入时 500ms 防抖触发 typing(true),3s 无输入触发 typing(false)
- 被禁言(muted=true)禁用发送并提示;仍可查看
- 草稿自动保存(IMLib.saveTextMessageDraft),发送成功后清空
- 群聊支持 @ 选择器(全员/指定成员),生成 mentionedInfo
数据源
未在 IDL 声明 dataSource;由宿主从 IMLib 拉取(getConversationList / getHistoryMessages / MESSAGES / CONVERSATION 事件)。
依赖边界
组件不直连网络与数据库:会话/消息由宿主从 IMLib 拉取后传入,组件只做排序、角标、格式化与渲染。
平台绑定
| 项 | 值 |
|---|---|
| 公开符号 / 签名 | IMPMessageInput |
| 导出列表包含 | 是 |
| UI 框架 | UIKit 视图容器 + 组件协议(Swift / Objective-C 双接口),宿主负责装配页面 |
使用示例
Objective-C 示例已隐藏(含未导出符号)
该示例引用了 SDK 头文件未导出的符号(多为 Swift 专用 helper)。请使用下表真实 ObjC 类,或参考对应组件页的 Objective-C 接入说明。
| 可用 ObjC 类 | 用途 |
|---|---|
IMPOSClient | IMLib 客户端(连接、消息、会话、群组等) |
IMPOSChatViewController | IMKit 会话页(真实 ObjC 类) |
IMPOSConversationListViewController | IMKit 会话列表页(真实 ObjC 类) |
IMPOSGlobalChatViewController | Global UIKit 会话页(真实 ObjC 类) |
IMPOSGlobalChatListViewController | Global UIKit 会话列表页(真实 ObjC 类) |
let view = MessageInputView(frame: .zero)
view.draft = "明天见"
container.addSubview(view)