Collapsible
示例代码Go · 可复制
这是上方组件库展示案例的完整源码。examples/components/collapsible.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("collapsible", "display", func() core.Widget {
field := kit.Input(demoText("Order number", "订单编号"))
field.SetValue("SO-1001")
details := kit.Collapsible(demoText("Order details", "订单详情"), field)
details.SetValue(true)
separate := kit.Collapsible(demoText("Advanced filters", "高级筛选"), kit.Input("").Placeholder(demoText("Customer name", "客户名称"))).Heading(el.ViewFunc(func(cx *el.Context) el.Element {
return el.Div().Row().Gap(8).Child(kit.Icon(kit.IconSearch).Size(16).Render(cx), el.Text(demoText("Advanced filters", "高级筛选")).Bold(), kit.Tag(demoText("Optional", "可选")).Render(cx))
}))
return el.Root(el.ViewFunc(func(cx *el.Context) el.Element {
return el.Div().P(24).Gap(16).Items(el.Stretch).Child(
el.Text("Collapsible").TextSize(24).Bold(), details.Render(cx),
el.Div().Rounded(8).Border(1, theme.Outline).Child(separate.Trigger().Render(cx), el.Text(demoText("Description text can appear between the trigger and content.", "触发器与内容之间可以放说明文字。")).Px(14).TextColor(theme.Muted), separate.Content().Render(cx)),
el.Text(demoText("Repeated clicks reverse the animation. Reduced motion expands immediately.", "快速重复点击可反转动画;减少动画设置下立即展开。")),
)
}))
})
}
单节内容的展开/收起状态,可整体使用,也可把触发器与内容分别放进布局。
section := kit.Collapsible("高级筛选", form)
section.SetValue(true)
// 默认带边框的面板:section.Render(cx)
row.Child(section.Trigger().Render(cx))
body.Child(section.Content().Render(cx))
Value / SetValue 读取和设置状态,程序设置不回调;OnChange 在用户切换时调用。SetDisabled 同时禁用独立触发器和内容。每个实例的 Trigger / Content 各渲染一次,不要同时再调用整体 Render。
Heading(view) 自定义标题的展示内容,构造时的 label 仍作为无障碍名称。标题内部放文字、图标等展示内容,避免嵌套另一个交互控件。
触发器支持 Tab、Enter / Space,角色为 disclosure,值为 expanded / collapsed。关闭正在编辑的内容时,焦点回到触发器,输入状态保留。收起中的内容不能操作。
展开与收起使用 180ms 高度动画;重复切换从当前高度反转,正文维持自然布局,不挤压文字。减少动画时立即切换,初始展开状态也直接显示。
验证:go run ./examples/components -section collapsible,加 -theme dark 检查深色。