MujicaUI/docs/components/201-chat-container.md

201 ChatContainer 对话容器

用途

整页对话布局：左侧可选侧栏插槽，右侧为消息区与底部输入区。消息区就是 MessageList：新消息到来时自动滚到底部，用户向上翻看时停止跟随，并在底部显示回到最新按钮。

最小示例

mujica.ChatContainer(c, &chat, len(msgs), mujica.ChatContainerOptions{
	List:  mujica.MessageListOptions{ID: func(i int) string { return msgs[i] }},
	Input: func() { ui.Text(c, "Composer goes here") },
}, func(i int) { ui.Text(c, msgs[i]) })

签名：func ChatContainer(c *ui.Context, s *MessageListState, n int, opts ChatContainerOptions, row func(i int)) MessageListResult

参数

字段	类型	默认值	含义
s	*MessageListState	必填	消息区的位置与已读状态，由调用方持有。
n / row	int / func(i int)	必填	消息数量与第 i 条消息的构建函数；只构建可见消息。
List	MessageListOptions	ID 必填	传给消息列表的选项，见 202。
Input	func()	nil	输入区插槽，位于消息区下方，带上边线。
Sidebar	func()	nil	侧栏插槽；nil 时不显示侧栏。
SidebarWidth	float32	260	侧栏宽度 DIP；负数 panic。

状态

消息区跟随底部 / 用户上翻后停止跟随；离开底部时出现带未读数的回到最新按钮。

事件

返回的 MessageListResult.Unread() 给出离开底部后新到的消息数。

键盘操作

Tab 在侧栏、消息与输入区之间移动；消息区获得焦点后滚轮与 PageUp/PageDown（Linux、Windows）滚动。

限制

• 侧栏宽度固定，不提供拖动调整；需要时用 SplitPane（008）包裹。