Keel v0.5.1 English GitHub

CopyButton

在线示例:这是真实的 Keel 程序编译成 WebAssembly,可以直接操作。首次加载约 10 MB。全屏打开
示例代码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) 清除反馈。