Message
示例代码Go · 可复制
这是上方组件库展示案例的完整源码。examples/components/message.go
在脚手架项目中复用组件构造和 Render 写法;示例的 registerSection 与共享辅助函数由组件库提供。
package main
import (
"github.com/dyike/keel/ui/core"
"github.com/dyike/keel/ui/el"
"github.com/dyike/keel/ui/kit"
"github.com/dyike/keel/ui/theme"
)
func init() {
registerSection("message", "chat", func() core.Widget {
say := func(s string) el.View { return el.ViewFunc(func(*el.Context) el.Element { return el.Text(s) }) }
answer := demoText("Order SO-1021 is paid and should arrive within 3 days. Should I ask the warehouse to prioritize it?", "订单 SO-1021 已付款,预计 3 天内送达。需要我通知仓库优先处理吗?")
copy := kit.CopyButton(func() string { return answer })
failed := kit.Message(demoText("Me", "我"), say(demoText("Please prioritize this order", "请优先处理这笔订单"))).User()
failed.SetState(kit.MessageFailed, demoText("Connection lost", "网络中断"))
failed.OnRetry(func() { failed.SetState(kit.MessageReady, "") })
reply := kit.Message(demoText("AI assistant", "AI 助手"), say(answer)).
Avatar(kit.Avatar("AI").Size(32)).
Header(say(demoText("AI assistant · Just now", "AI 助手 · 刚刚"))).
Footer(say(demoText("Order data synced", "订单数据已同步"))).Actions(copy).
Reactions(kit.MessageReaction{Name: demoText("Helpful", "有帮助"), Count: 2}).OnReaction(func(int, bool) {})
notice := kit.Message(demoText("System", "系统"), nil).Avatar(nil).
Bubble(kit.Bubble(say(demoText("This conversation has been saved to the order record.", "这段对话已保存到订单记录。"))).Variant(kit.BubbleGhost)).
Header(kit.Label(demoText("System message", "系统消息"))).Footer(kit.Label(demoText("Visible to this team only", "仅当前团队可见"))).
PartStyle(kit.MessagePartRoot, func(e *el.DivEl) { e.P(theme.SpaceLg).Bg(theme.Subtle).Rounded(theme.RadiusMd) }).
PartStyle(kit.MessagePartStack, func(e *el.DivEl) { e.Gap(theme.SpaceSm) })
positioned := kit.Message(demoText("Me", "我"), say(demoText("User messages can also be independently left-aligned.", "用户消息也可以独立靠左排版。"))).User().Alignment(el.Start).Header(kit.Label(demoText("Custom message placement", "自定义消息位置")))
return el.Embed(el.ViewFunc(func(cx *el.Context) el.Element {
return el.Div().P(24).Gap(16).W(el.Dp(520)).MaxW(el.Full).Child(
kit.Message(demoText("Me", "我"), say(demoText("When will SO-1021 arrive?", "SO-1021 什么时候到?"))).User().Render(cx),
reply.Render(cx), failed.Render(cx), notice.Render(cx), positioned.Render(cx))
}))
})
}
对话中的一条消息:头像、内容、操作栏。
kit.Message("我", text).User() // 用户消息:靠右的气泡,不显示头像
kit.Message("AI 助手", answerDoc).Actions(copy) // 其他人:头像 + 整宽内容 + 操作栏
- 非用户消息占满宽度,适合长篇 Markdown 回答。头像显示作者名字的首字母。
Actions(views...)显示在内容下方,比如复制、重试按钮。流式输出还没结束时,通常先不加操作。
Agent:每条消息是 article,名字是作者,内容和操作按钮单独列出。
验证:go run ./examples/components -section message,加 -theme dark 检查深色。
SetState(MessageSending, "") 显示发送中;SetState(MessageFailed, reason) 显示失败原因。OnRetry(fn) 在失败时显示重试按钮,点击先转为发送中,再调用一次业务回调;业务完成后设置 MessageReady,再次失败则设置 MessageFailed。
用户和助手消息都支持 Actions,传入切片会被复制,空槽位会被忽略。操作栏是否在流式输出期间显示由应用决定。SetDisabled(true) 禁止消息内的操作、反应和重试。
msg.Reactions(kit.MessageReaction{Name: "有帮助", Count: 2}).
OnReaction(func(index int, active bool) { /* 保存到服务端 */ })
反应使用可切换按钮,点击更新当前用户的选中状态与计数,再调用回调。Reactions 复制数据;后续服务端结果可再次调用它覆盖。未提供回调的反应只读。Agent 可读取 article 的 sending / failed 状态,以及反应按钮的选中状态。
Avatar(view) 替换头像,传 nil 隐藏;DefaultAvatar() 恢复默认:助手显示姓名首字母,用户消息不显示头像。用户消息显式配置头像时放在右侧。头像按正文容器底边对齐,头部在上方,状态、操作、反应及尾部继续排在正文列下方;定位使用当前帧布局,较高的头像会撑开上方空间。正文被隐藏或不存在时,以正文列底边作为回退。
Header(view) 放在正文上方,Footer(view) 放在状态、操作和反应区之后;传 nil 清除。头尾支持任意 View 和可交互控件,默认继承小号、弱化文字样式,用户消息靠右。Content(view) 独立替换正文,nil 清空正文但保留其他分区。消息禁用状态覆盖所有插槽。
msg.Avatar(kit.Avatar("Alice").Size(32)).
Header(kit.Label("Alice · 10:24")).
Footer(kit.Button("回复", reply))
插入、删除头像或头尾时,正文的身份保持稳定,输入内容和焦点不变。普通用户气泡和显式 Bubble 的头尾默认使用 theme.SpaceLg 水平缩进;普通助手正文保持无缩进。完整消息行可用 MessageGroup 分组。
Bubble(surface) 安装显式气泡,避免 User 消息再包一层气泡。组件以副本渲染,气泡对齐跟随消息;修改原气泡的变体会在下一帧体现,不会反向修改原实例。传 nil 清空正文;Content(view) 恢复普通正文模式(User 自动包气泡)。
surface := kit.Bubble(answer).Variant(kit.BubbleGhost)
msg.Bubble(surface).Header(kit.Label("系统消息")).Footer(kit.Label("刚刚"))
msg.HeaderInset(true).FooterInset(false)
msg.ResetContentInsets() // 恢复自动规则
显式 Ghost 气泡自动取消头尾缩进;HeaderInset、FooterInset 分别覆盖继承规则。普通 Content 内部的自定义 View 不参与 Ghost 检测。该入口接受单个 Bubble;多个气泡与附件混排使用 MessageContent,直接气泡共同参与 Ghost 继承。
Alignment(el.Start/el.End) 独立控制左右位置,覆盖 User 的默认靠右布局;ResetAlignment() 恢复默认。头像、头尾、状态、操作和反应跟随位置,显式气泡也跟随。User 仍决定默认气泡色和是否显示默认头像,改对齐不会改变这些设置。其他 Align 值忽略。普通正文靠右时按自身宽度布局,撑满宽度的控件仍占满正文列。
PartStyle(part, func(*el.DivEl)) 在每帧默认布局之后配置分区样式,nil 恢复默认,非法 part 忽略。可选分区:Root(外层)、Stack(正文列)、Avatar、Header、Content、Footer、Status、Actions、Reactions,对应常量均以 MessagePart 开头。头尾样式在自动缩进及显式覆盖后执行,可进一步调整内边距。
msg.PartStyle(kit.MessagePartRoot, func(e *el.DivEl) {
e.P(theme.SpaceLg).Bg(theme.Subtle).Rounded(theme.RadiusMd)
}).PartStyle(kit.MessagePartStack, func(e *el.DivEl) {
e.Gap(theme.SpaceSm)
})
回调只修改当帧元素,不应保留它或追加子项。组件保留内部 ID、外层 article 的名称/状态及整体禁用;分区可额外禁用自身,不能绕过祖先禁用。Content 样式作用于正文容器,气泡表面仍由 Bubble 的样式接口控制。
自定义 MessagePartRoot 的 Items 可覆盖默认底边对齐;MessagePartStack 的 ContentBottom 可选择另一后代作为对齐目标。改变这些布局规则由应用负责。默认头像仍为 28dp,助手自动显示头像、User 自动包主色气泡的约定保留,与上游默认无槽位不同。