Keel v0.5.1 English GitHub

Accordion

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

这是上方组件库展示案例的完整源码。examples/components/accordion.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("accordion", "display", func() core.Widget {
		txt := func(s string) el.View { return el.ViewFunc(func(*el.Context) el.Element { return el.Text(s) }) }
		name := kit.Input(demoText("Display name", "显示名称")).Placeholder(demoText("Input is preserved when collapsed", "收起后保留输入内容"))
		one := kit.Accordion().Add(demoText("Profile", "个人资料"), name).Add(demoText("Notification settings", "通知设置"), kit.Switch(demoText("Receive notifications", "接收通知"), true)).Add(demoText("Unavailable", "暂不可用"), txt(demoText("Disabled item", "禁用项目")))
		one.Heading(0, el.ViewFunc(func(cx *el.Context) el.Element {
			return el.Div().Row().Gap(8).Child(kit.Icon(kit.IconUser).Size(16).Render(cx), el.Text(demoText("Profile", "个人资料")).Bold(), kit.Tag(demoText("Editable", "可编辑")).Render(cx))
		}))
		one.SetValue(0)
		one.SetItemDisabled(2, true)
		faq := kit.Accordion().Multiple().
			Add(demoText("How do I use the keyboard?", "如何用键盘操作?"), txt(demoText("Tab focuses a heading; ↑ ↓ changes headings; Enter or Space expands; Home / End jumps to the first or last heading.", "Tab 聚焦标题,↑ ↓ 切换标题,Enter 或空格展开,Home / End 跳到首尾。"))).
			Add(demoText("Can multiple items be expanded?", "可以同时展开多项吗?"), txt(demoText("Multiple is enabled, so two items can be expanded at once.", "这个面板启用了 Multiple,可以同时展开两项。")))
		small := kit.Accordion().Size(kit.AccordionSizeSmall).Bordered(false).
			Add(demoText("Small · Borderless", "Small · 无边框"), txt(demoText("Hide the outer border and section dividers; keep the background and rounded corners.", "隐藏外框和分节线,保留背景与圆角。"))).
			Add(demoText("Second section", "第二节"), txt(demoText("Changing size preserves the expanded state.", "尺寸切换不改变展开状态。")))
		small.SetValue(0)
		large := kit.Accordion().Size(kit.AccordionSizeLarge).Add(demoText("Large", "Large · 大尺寸"), txt(demoText("The heading, arrow, spacing, and body adjust together.", "标题、箭头、间距与正文一起调整。")))
		large.SetValue(0)
		tiny := kit.Accordion().Size(kit.AccordionSizeXSmall).Add(demoText("XSmall · Compact", "XSmall · 紧凑"), txt(demoText("Suitable for information-dense panels.", "适用于信息密集的面板。")))
		return el.Embed(el.ViewFunc(func(cx *el.Context) el.Element {
			return el.Div().P(24).Gap(16).W(el.Dp(480)).MaxW(el.Full).Child(one.Render(cx), faq.Render(cx), small.Render(cx), large.Render(cx), tiny.Render(cx))
		}))
	})
}

可展开的分节面板。默认同时只展开一节,Multiple() 后可以展开多节。

faq := kit.Accordion().Add("如何退款?", answer1).Add("多久到账?", answer2).Multiple()
  • 标题可以获得焦点:↑ ↓ Home End 在标题之间移动,会跳过禁用的节;回车或空格展开、收起。
  • Value() 返回已展开节的序号;SetValue(i...) 不触发回调,单节模式只保留第一个;SetItemDisabled(i, bool)。

Agent:容器角色 group;每个标题是 disclosure,value 为 expanded / collapsed;展开的内容单独列出。

验证:go run ./examples/components -section accordion,加 -theme dark 检查深色。

Heading(i, view) 自定义第 i 项的展示标题,原 title 仍作为无障碍名称。Trigger(i) 和 Content(i) 可分开放进自定义布局,每项各渲染一次;不要同时再渲染完整 Accordion。方向键会跳过未渲染、禁用或位于禁用容器中的标题。

SetDisabled 禁用整组,SetItemDisabled 同时禁用该项的标题与已展开内容,但保留展开状态。展开/收起有 180ms 动画,连续切换从当前高度反转;减少动画立即切换。收起时输入状态保留,焦点若在正文中会回到标题,收起过程不能继续操作正文。

Bordered(false) 隐藏外框与分节分隔线,保留背景、圆角和展开状态;默认无外框,Bordered(true) 显式开启外框。Size 支持 AccordionSizeXSmall、AccordionSizeSmall、AccordionSizeMedium(默认)、AccordionSizeLarge,统一调整标题、箭头、间距与正文继承字号。默认档保留原有字号继承;自定义标题或正文显式设置的字号优先。