输入区（MessageInput）

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

契约属性（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 拉取后传入，组件只做排序、角标、格式化与渲染。

平台绑定​

项值
公开符号 / 签名im_kit_message_model_add_pending
导出列表包含—
UI 框架view-model / 格式化 / 角标 / 状态计算层（不访问网络，不渲染 UI）

使用示例​

C（view-model 层）
char client_msg_id[64];
int rc = im_kit_message_model_add_pending(
    chat, "{\"type\":\"text\",\"text\":\"你好，NI PaaS\"}", "alice", now_ms,
    client_msg_id, sizeof(client_msg_id));
/* 发送成功后用服务端消息替换 pending 气泡 */
im_kit_message_model_ack(chat, client_msg_id, server_message_json);

相关文档​