AttachmentGroup
示例代码Go · 可复制
这是上方组件库展示案例的完整源码。examples/components/attachment_group.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("attachment_group", "chat", func() core.Widget {
first := kit.Attachment(demoText("report.pdf", "报告.pdf"), 2048)
second := kit.Attachment(demoText("image.png", "图片.png"), 4096)
pending := kit.Attachment(demoText("pending-upload.zip", "待上传.zip"), 8192)
pending.SetStatus(kit.AttachmentStatusPending)
processing := kit.Attachment(demoText("processing.mp4", "处理中.mp4"), 16000)
processing.SetStatus(kit.AttachmentStatusProcessing)
processing.OnCancel(func() {}).OnRetry(func() {})
group := kit.AttachmentGroup(first, second, pending, processing).Name(demoText("Attachments", "附件")).Gap(12)
second.OnRemove(func() { group.SetItems(first, pending, processing) })
sizes := []*kit.AttachmentView{
kit.Attachment("XSmall.pdf", 1024).Size(kit.AttachmentSizeXSmall),
kit.Attachment("Small.pdf", 1024).Size(kit.AttachmentSizeSmall),
kit.Attachment("Medium.pdf", 1024).Size(kit.AttachmentSizeMedium),
kit.Attachment("Large.pdf", 1024).Size(kit.AttachmentSizeLarge),
}
return el.Embed(el.ViewFunc(func(cx *el.Context) el.Element {
group.EdgeFade(theme.Bg)
paging := el.Div().Wrap().Gap(8).Child(
kit.Button(demoText("Previous screen", "前一屏"), func() { offset, width, _ := group.ScrollState(cx); group.ScrollTo(offset - width) }).Render(cx),
kit.Button(demoText("Next screen", "后一屏"), func() { offset, width, _ := group.ScrollState(cx); group.ScrollTo(offset + width) }).Render(cx),
)
box := el.Div().P(24).Gap(12).Child(el.Text(demoText("Scroll horizontally; remove buttons update the attachment group", "横向滚动查看;移除按钮更新附件组")), paging, group.Render(cx))
for _, a := range sizes {
box.Child(a.Render(cx))
}
return box
}))
})
}
横向排列附件,超出容器时滚动。每项保留自己的上传状态和操作回调。
files := kit.AttachmentGroup(report, photo).Name("附件").Gap(12)
photo.OnRemove(func() { files.SetItems(report) })
默认间距为 SpaceSm,各项顶对齐且不压缩宽度。SetItems 和 Items 隔离切片修改,忽略 nil 条目;元素实例仍共享,同一个实例不要重复渲染。SetDisabled 禁止组内操作,不修改附件自身设置。
Agent:组角色为 group,名称由 Name 设置;内部附件和操作保留各自语义。
运行 go run ./examples/components -section attachment_group,横向滚动后移除附件。媒体和上传操作见 Attachment。
ScrollTo(dp) 请求绝对水平偏移,可在首次显示前调用;负值回到起点,NaN/Inf 忽略。请求在实际绘制后按当前内容限制到有效范围,隐藏期间保留。程序滚动即使组内操作禁用也可用,不触发附件选择或打开;后台调用应通过 core.Update 安排到 UI 线程。
ScrollState(cx) 返回水平偏移、可视宽度和内容宽度,单位 dp;首次绘制前为零。示例中的“前一屏/后一屏”按钮用当前偏移加减可视宽度。接口读取当前 root 的状态,同一组实例应只在一个位置渲染。
next := kit.Button("后一屏", func() {
offset, width, _ := files.ScrollState(cx)
files.ScrollTo(offset + width)
})
EdgeFade(color) 在还有隐藏内容的一侧绘制 24dp 渐隐,颜色应与组周围的背景一致;内容完全可见时不显示,到达起点/终点时分别隐藏左/右渐隐。窄容器中每侧宽度最多占一半,底部滚动条不被覆盖。渐隐只绘图,不添加命中区域,不阻挡附件操作。ClearEdgeFade() 关闭,默认不开启;主题变化时可在 Render 中重新传入当前主题背景色。