Keel v0.5.1 English GitHub

AttachmentGroup

在线示例:这是真实的 Keel 程序编译成 WebAssembly,可以直接操作。首次加载约 10 MB。全屏打开
示例代码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 中重新传入当前主题背景色。