Keel v0.5.1 English GitHub

Button

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

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

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

package main

import (
	"fmt"
	"github.com/dyike/keel/ui/core"
	"github.com/dyike/keel/ui/el"
	"github.com/dyike/keel/ui/kit"
	"github.com/dyike/keel/ui/theme"
	"image/color"
)

func init() { registerSection("button", "general", buttonGallery) }

type buttonDemo struct {
	save    *kit.ButtonView
	toggle  *kit.ButtonView
	count   int
	loading bool
	bold    *kit.ButtonView
}

func buttonGallery() core.Widget {
	v := &buttonDemo{}
	v.save = kit.Button(demoText("Save 123", "保存 Save 123"), func() { v.count++ }).Icon(kit.IconPlus)
	v.toggle = kit.Button(demoText("Toggle loading state", "切换加载状态"), func() { v.loading = !v.loading; v.save.SetLoading(v.loading) }).Variant(kit.ButtonSecondary)
	v.bold = kit.Button(demoText("Bold", "加粗"), nil).Variant(kit.ButtonGhost).Selected(true)
	return el.Embed(v)
}
func (v *buttonDemo) Render(cx *el.Context) el.Element {
	row := func(views ...el.View) el.Element {
		d := el.Div().Wrap().Gap(12).Items(el.Center)
		for _, view := range views {
			d.Child(view.Render(cx))
		}
		return d
	}
	rich := el.ViewFunc(func(*el.Context) el.Element {
		return el.Div().Row().Gap(theme.SpaceSm).Child(el.Text(demoText("Export", "导出")), el.Text("CSV").Bold())
	})
	custom := func(a kit.ButtonAppearance) kit.ButtonAppearance {
		a.Background = color.NRGBA{R: 110, G: 60, B: 170, A: 255}
		a.Hover, a.Active = a.Background, a.Background
		a.Foreground, a.HoverForeground, a.ActiveForeground = color.NRGBA{R: 255, G: 255, B: 255, A: 255}, color.NRGBA{R: 255, G: 255, B: 255, A: 255}, color.NRGBA{R: 255, G: 255, B: 255, A: 255}
		return a
	}
	disabled := kit.Button(demoText("Disabled", "不可操作"), nil)
	disabled.SetDisabled(true)
	return el.Div().P(24).Gap(16).Child(
		el.Text(demoText("Button", "按钮")).TextSize(24).Bold(),
		el.Text(demoText("Tab focuses; Enter / Space activates. Loading and disabled buttons do not respond.", "Tab 聚焦;Enter / Space 激活。加载和禁用时不响应。")),
		row(kit.Button(demoText("Primary", "主要"), nil), kit.Button(demoText("Secondary", "次要"), nil).Variant(kit.ButtonSecondary), kit.Button(demoText("Lightweight", "轻量"), nil).Variant(kit.ButtonGhost), kit.Button(demoText("Delete", "删除"), nil).Variant(kit.ButtonDanger)),
		row(kit.Button(demoText("Small 28", "小 28"), nil).Size(28), kit.Button(demoText("Standard 32", "标准 32"), nil), kit.Button(demoText("Large 40", "大 40"), nil).Size(40)),
		row(kit.Button(demoText("Link", "链接"), nil).Variant(kit.ButtonLink), kit.Button(demoText("Text", "文字"), nil).Variant(kit.ButtonText), kit.Button(demoText("Success", "成功"), nil).Variant(kit.ButtonSuccess), kit.Button(demoText("Warning", "警告"), nil).Variant(kit.ButtonWarning), kit.Button(demoText("Info", "信息"), nil).Variant(kit.ButtonInfo)),
		row(kit.Button(demoText("Tinted", "着色"), nil).Outline(true), kit.Button(demoText("Danger tinted", "危险着色"), nil).Variant(kit.ButtonDanger).Outline(true), kit.Button(demoText("Compact", "紧凑"), nil).Compact(true), kit.Button("", nil).Name(demoText("Add", "添加")).Icon(kit.IconPlus)),
		row(kit.Button(demoText("Export CSV", "导出 CSV"), nil).Content(rich), kit.Button(demoText("Exporting", "正在导出"), nil).Content(rich).Loading(true), kit.Button(demoText("Custom palette", "自定义配色"), nil).Appearance(custom)),
		row(v.save, v.toggle),
		el.Text(fmt.Sprintf(demoText("Save count: %d", "保存次数:%d"), v.count)).TextColor(theme.Muted),
		row(kit.Button(demoText("Loading", "加载中"), nil).Loading(true), kit.Button(demoText("Loading icon", "加载图标"), nil).Icon(kit.IconPlus).Loading(true), disabled),
		el.Div().W(el.Dp(140)).Child(kit.Button(demoText("Narrow container: English 123", "窄容器中文 English 123"), nil).Render(cx)),
		el.Text(demoText("Selected state", "选中状态")).TextSize(16).Bold(),
		row(kit.Button(demoText("Selected", "已选中"), nil).Selected(true), kit.Button(demoText("Secondary selected", "次要已选中"), nil).Variant(kit.ButtonSecondary).Selected(true),
			kit.Button(demoText("Tinted selected", "着色已选中"), nil).Outline(true).Selected(true), v.bold),
	)
}

基于 el 的操作按钮,支持鼠标、键盘、图标和加载状态。默认 Primary 外观、32dp 高度、6dp 圆角;颜色在 Render 中读取当前主题。

save := kit.Button("保存", saveOrder).Icon(kit.IconPlus)
deleteButton := kit.Button("删除", deleteOrder).Variant(kit.ButtonDanger)

Variant 接受 ButtonVariant:ButtonPrimary(零值)、ButtonSecondary、ButtonGhost、ButtonDanger、ButtonLink、ButtonText、ButtonSuccess、ButtonWarning、ButtonInfo。仅用 Variant 配置外观,不提供 Danger 等快捷入口。Size(float32) 指定高度 dp,推荐 28 / 32 / 40;非正数和非有限数忽略。窄容器限制为单行,遵守可用宽度。

Outline(true) 为兼容保留,表示无边框的着色样式:背景透明,文字使用对应变体色,悬停使用 Subtle,按下使用 SubtleHover。Compact(true) 缩小水平内边距,保留高度。Link 默认无水平内边距,Text 保留内边距。只有图标、没有文案的按钮为正方形,使用 Name 设置可访问名称。

Content(el.View) 替换可见文案和图标,传 nil 恢复。内容应为展示元素,不嵌套按钮或输入框;构造时的文案(或 Name)仍作为可访问名称。加载时隐藏内容的绘制并保留布局,在中央显示进度环。

Appearance(func(ButtonAppearance) ButtonAppearance) 在每次 Render 时修改当前变体配色,可配置正常、悬停、按下和键盘焦点颜色。ButtonAppearance.Border 已弃用并忽略。传 nil 恢复主题配色;自定义配色不使用 PrimaryGradient。成功、警告、信息变体按底色选择黑字或白字。禁用按钮仍无边框,使用主题禁用色。

Icon(IconName) 配置前置图标。Loading(bool) 设置加载状态,SetLoading 可在回调中更新。加载时复用 Spinner 的动画:有图标时替换图标,无图标时保留文案的测量尺寸并在其上居中绘制 Spinner,因此切换前后按钮尺寸不变。减少动画设置开启时显示静止进度环。

SetText 更新文案,SetDisabled 更新禁用状态,均不触发点击回调。后台更新必须放在 core.Update 中。加载时保持焦点和 Tab 顺序,只忽略激活;不显示悬停、按下外观,使用默认光标。禁用时不参与 Tab 导航;父元素的 Disabled 同样限制按钮交互,同时禁用和加载时按禁用处理。Ghost、Link、Text 和 Outline 禁用时保持透明背景。

Tab / Shift+Tab 聚焦;Space / Enter 松开时激活一次。Hover、Active 和 FocusStyle 分别提供悬停、按下、焦点外观,不改变布局。按钮在默认、悬停、按下、选中、禁用和加载状态都不绘制常驻边框;只有键盘或程序聚焦时显示内嵌焦点环,鼠标聚焦不显示。

Agent 角色为 button,name 为文案;加载时 value 为 loading,disabled 为 false;只有自身或父元素禁用时 disabled 为 true。图标和 Spinner 是按钮内部装饰,不单独列入快照。

验证:go run ./examples/components -section button,加 -theme dark 检查深色。示例覆盖九种变体、着色/紧凑配置、自定义内容/配色、三个尺寸、图标、禁用、加载切换和窄容器。

选中状态

Selected(true) / SetSelected(on) 把按钮显示为已选中,例如工具栏里当前的视图、已启用的筛选;Agent 看到的 selected 为 true。实心按钮颜色加深;次要、轻量、文字和着色按钮使用 Highlight 底色与 PrimaryText 文字。点击不会自动切换,需要在 OnClick 里设置;一组互斥选项直接用 ToggleGroup。

按钮组见 ButtonGroup。

按钮尺寸设置最小高度。文字与自定义内容可随无障碍字体缩放撑高按钮, 并保留上下留白。