Keel v0.5.1 English GitHub

MessageContent

在线示例:这是真实的 Keel 程序编译成 WebAssembly,可以直接操作。首次加载约 10 MB。全屏打开
示例代码Go · 可复制

这是上方组件库展示案例的完整源码。examples/components/message_content.go

在脚手架项目中复用组件构造和 Render 写法;示例的 registerSection 与共享辅助函数由组件库提供。

package main

import (
	"github.com/dyike/keel/ui/core"
	"github.com/dyike/keel/ui/el"
	"github.com/dyike/keel/ui/kit"
)

func init() {
	registerSection("message_content", "chat", func() core.Widget {
		mixed := kit.MessageContent(
			kit.Bubble(kit.Label(demoText("Export complete. The file is below.", "导出已完成,文件在下方。"))),
			kit.Attachment(demoText("order-summary.csv", "订单汇总.csv"), 2048),
			kit.Bubble(kit.Label(demoText("The download link expires in 24 hours.", "下载链接将在 24 小时后过期。"))).Variant(kit.BubbleGhost),
		)
		msg := kit.Message(demoText("Assistant", "助手"), mixed).Header(kit.Label(demoText("Assistant · Just now", "助手 · 刚刚"))).Footer(kit.Label(demoText("Delivered", "已送达")))
		return el.Embed(el.ViewFunc(func(cx *el.Context) el.Element {
			return el.Div().P(24).Gap(16).Child(msg.Render(cx))
		}))
	})
}

在同一条 Message 正文中混排多个气泡、附件和普通 View。直接传入的 Bubble 会继承消息对齐;任一直接气泡为 Ghost 时,头尾自动取消缩进。HeaderInset/FooterInset 的显式设置仍优先。

content := kit.MessageContent(
    kit.Bubble(kit.Label("导出完成")),
    kit.Attachment("订单.csv", 2048),
    kit.Bubble(kit.Label("链接将在 24 小时后过期")).Variant(kit.BubbleGhost),
)
msg := kit.Message("助手", content).Header(kit.Label("刚刚"))

SetItems 复制新顺序并忽略 nil,空参数清空;Items 返回副本。应复用子项,每个实例只出现一次;自定义 View 需提供稳定 ID。存续气泡使用内部稳定副本渲染,动态重排保留其输入与焦点,原气泡的样式和对齐不会被修改。更改源气泡的变体会在下一帧更新样式和 Ghost 继承。

Gap 设置非负有限 dp,默认 theme.SpaceMd;Style 配置正文栈,nil 恢复默认。样式回调在默认值后执行,不应保留元素或添加子项。SetDisabled 禁用整个正文,祖先 Message 的禁用同样有效。

直接通过 Message 构造参数或 Content(content) 安装时,组件负责混排,不会再包一层 User 气泡。独立 Render 默认靠左,并使用接收方默认气泡颜色。普通 View 包裹后的气泡不会被递归检测;自动 Ghost 继承只针对直接 Bubble 子项。

运行:go run ./examples/components -section message_content,加 -theme dark 检查深色。