Accordion
示例代码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,统一调整标题、箭头、间距与正文继承字号。默认档保留原有字号继承;自定义标题或正文显式设置的字号优先。