输入区(MessageInput)

输入区:MessageInput 是 IDL 定义的跨端 UI 组件,props / events / behaviors 在各平台语义一致。本页给出契约属性、事件、渲染行为、数据源与 iOS 端绑定/示例。

契约属性(props)​

属性类型必填说明
draftstring是草稿文本
disabledbool是是否禁用输入
mutedbool是是否被禁言(禁言时禁用发送并提示)
mentionCandidatesUserProfile[]否@ 候选成员列表
maxLengthint否最大输入长度(默认 5000)

事件​

事件参数说明
sendtext,extras?输入区发送文本
typingbool输入状态变化(true / false)
pickImage—选择图片
pickFile—选择文件
startRecord—宿主回调(参数见 IDL 事件定义)
pickLocation—选择位置
draftChangeddraft草稿变化

渲染行为​

  • 输入时 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 类用途
IMPOSClientIMLib 客户端(连接、消息、会话、群组等)
IMPOSChatViewControllerIMKit 会话页(真实 ObjC 类)
IMPOSConversationListViewControllerIMKit 会话列表页(真实 ObjC 类)
IMPOSGlobalChatViewControllerGlobal UIKit 会话页(真实 ObjC 类)
IMPOSGlobalChatListViewControllerGlobal UIKit 会话列表页(真实 ObjC 类)
let view = MessageInputView(frame: .zero)
view.draft = "明天见"
container.addSubview(view)

相关文档​