CopyButton
示例代码Go · 可复制
这是上方组件库展示案例的完整源码。examples/components/copy_button.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("copy_button", "general", func() core.Widget {
cb := kit.CopyButton(func() string { return "SO-1001" })
last := demoText("Not copied yet", "尚未复制")
custom := kit.CopyButton(func() string { return "SO-1001" }).OnCopied(func(value string) { last = demoText("Last copied: ", "最近复制:") + value })
custom.Content(el.ViewFunc(func(cx *el.Context) el.Element {
label, icon := demoText("Copy order number", "复制订单号"), kit.IconCopy
if custom.Copied() {
label, icon = demoText("Order number copied", "订单号已复制"), kit.IconCheck
}
return el.Div().Row().Gap(8).Items(el.Center).Child(kit.Icon(icon).Render(cx), el.Text(label))
}))
return el.Embed(el.ViewFunc(func(cx *el.Context) el.Element {
return el.Div().P(24).Gap(8).Items(el.Start).Child(el.Text(demoText("Order number SO-1001", "订单号 SO-1001")), cb.Render(cx), custom.Render(cx), el.Text(last))
}))
})
}
把文字复制到剪贴板,并显示"已复制"作为反馈。
kit.CopyButton(func() string { return order.ID })
- 文字在点击时才读取,所以函数总能拿到最新内容。
- 复制后,按钮显示"已复制"和对勾图标,
kit.CopiedFeedback(1.5 秒)后恢复为"复制"。 - 按钮是 Ghost 样式,高 28dp,支持 Tab 聚焦和 Space / Enter 触发。
Agent:角色是 button,名字在"复制"和"已复制"之间切换。
验证:go run ./examples/components -section copy_button。
连续点击会在每次复制后重新保留完整的 1.5 秒反馈,不沿用上次的截止时间。SetDisabled(true) 禁用复制并清除反馈;祖先禁用也会阻止读取文字和写剪贴板。传入 nil 取值函数时点击不会显示“已复制”。
OnCopied(func(string)) 在提交剪贴板写入请求后调用,参数是本次提交的原文,不会再次读取取值函数。系统剪贴板没有成功确认信号,因此此回调不代表操作系统已确认写入。禁用或取值函数为 nil 时不调用;传入 nil 可移除回调。
Content(el.View) 替换默认图标和文字,保留按钮的键盘操作及“复制”/“已复制”语义名称。内容应为文字、图标等展示元素,避免嵌套输入框或按钮。自定义内容最小高 28dp,可随内容增高;传入 nil 恢复默认按钮。
copy := kit.CopyButton(func() string { return order.ID }).
OnCopied(func(value string) { lastCopied = value })
copy.Content(el.ViewFunc(func(cx *el.Context) el.Element {
label := "复制订单号"
if copy.Copied() {
label = "订单号已复制"
}
return el.Text(label)
}))
Copied() 提供当前反馈状态。自定义内容与默认按钮共用 1.5 秒计时;每次复制重新计时,SetDisabled(true) 清除反馈。