Keel v0.5.1 English GitHub

DropdownButton

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

这是上方组件库展示案例的完整源码。examples/components/dropdown_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"
	"github.com/dyike/keel/ui/theme"
)

func init() {
	registerSection("dropdown_button", "general", func() core.Widget {
		msg := demoText("No action yet", "还没有操作")
		set := func(s string) func() { return func() { msg = s } }
		export := kit.DropdownButton(demoText("Export", "导出"), kit.Menu().Item("PDF", "", set(demoText("Export PDF", "导出 PDF"))).Item("CSV", "", set(demoText("Export CSV", "导出 CSV")))).Variant(kit.ButtonSecondary)
		save := kit.DropdownButton(demoText("Save", "保存"), kit.Menu().Item(demoText("Save as…", "另存为…"), "mod+shift+s", set(demoText("Save as", "另存为"))).Item(demoText("Save all", "保存全部"), "", set(demoText("Save all", "保存全部")))).Split(set(demoText("Save", "保存")))
		busy := kit.DropdownButton(demoText("Saving", "保存中"), kit.Menu().Item(demoText("View records", "查看记录"), "", set(demoText("View records", "查看记录")))).Button(kit.Button(demoText("Saving", "保存中"), nil).Icon(kit.IconDone).Loading(true).Variant(kit.ButtonSecondary).Size(40))
		return el.Root(el.ViewFunc(func(cx *el.Context) el.Element {
			return el.Div().P(24).Gap(12).Items(el.Start).Child(
				el.Text(demoText("DropdownButton: use the whole button as a menu trigger or split it into a primary action and an arrow.", "DropdownButton:整体打开菜单,或分体(主操作 + 箭头)")).Bold(),
				el.Div().Row().Gap(12).Child(export.Render(cx), save.Render(cx)),
				busy.Render(cx),
				el.Text(msg).TextColor(theme.Muted),
			)
		}))
	})
}

带下拉菜单的按钮。

kit.DropdownButton("导出", formats)              // 整个按钮打开菜单
kit.DropdownButton("保存", more).Split(save)     // "保存"执行 save,旁边的箭头打开菜单
  • 菜单是普通的 kit.Menu,键盘、子菜单、禁用项的行为都和 Menu 一致。
  • Variant(kit.ButtonSecondary) 等设置按钮外观,分体样式下两个部分使用同一外观。
  • SetDisabled(true) 同时禁用按钮和箭头,并关闭已打开的菜单。
  • 需要 el.Root。

Agent:整体样式下,按钮名字就是标题;分体样式下,主操作按钮名为标题,箭头按钮名为"标题 更多选项"。

验证:go run ./examples/components -section dropdown_button。

菜单参数为 nil 时使用空菜单,Split 主操作仍可用。SetDisabled(true) 同时禁用主按钮和菜单所在区域;即使外部持有 Menu 并调用 SetValue(true),禁用的锚点也不会显示弹层。祖先禁用也遵循相同规则。

Button(button) 使用已有 Button 配置主操作,并启用分体模式;支持其文字、可访问名称、图标、富内容、配色、紧凑/描边、加载和点击回调。渲染复制配置,不修改原 Button;内部采用组件自己的稳定 ID,忽略传入 Button 的 ID。若同时设置 Split,以 Split 的动作优先。Button(nil) 恢复原普通/Split 用法。

Size(dp) 设置两部分高度,0 恢复内层按钮或默认高度;负数和非有限值忽略。不显式设置 Variant/Size 时,两部分继承内层按钮的变体和高度;图标、内容、配色回调等仅属于主操作。

Loading(bool) 覆盖主按钮的加载状态。普通模式下不能通过加载中的按钮打开菜单;分体模式下箭头仍可打开菜单。已经打开的菜单不因 Loading 关闭。SetDisabled(true) 则始终禁用两部分并关闭菜单。内层 Button 自身禁用仅影响主操作。

kit.DropdownButton("保存", more).
    Button(kit.Button("保存", save).Icon(kit.IconDone).Loading(saving)).
    Size(40)

Placement(side, align) 设置顶层菜单方向(Top/Bottom/Left/Right)和对齐(Start/Center/End),默认 Bottom/Start;非法组合忽略。Offset(dp) 设置间距,默认 4dp,支持 0 和负值重叠,非有限值忽略。打开期间可更新,空间不足时沿用浮层翻转和窗口内限制。子菜单仍按 Right/Start、2dp 展开。

DropdownButton 的这两个方法直接配置传入的 Menu;普通模式锚定整按钮,分体模式锚定箭头。共用同一 Menu 的调用方也会看到配置变化。