44 lines
1.7 KiB
Markdown
44 lines
1.7 KiB
Markdown
# 201 ChatContainer 对话容器
|
||
|
||
## 用途
|
||
|
||
整页对话布局：左侧可选侧栏插槽，右侧为消息区与底部输入区。消息区就是 MessageList：新消息到来时自动滚到底部，用户向上翻看时停止跟随，并在底部显示回到最新按钮。
|
||
|
||
## 最小示例
|
||
|
||
```go
|
||
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）包裹。
|