Tabs
示例代码Go · 可复制
这是上方组件库展示案例的完整源码。examples/components/tabs.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"
)
func init() {
registerSection("tabs", "navigation", func() core.Widget {
tabs := kit.Tabs().
Add(demoText("General", "基本"), kit.Input(demoText("Name", "名称")).Placeholder(demoText("Content is preserved after switching", "切换后内容保留"))).
Add(demoText("Notifications", "通知"), kit.Switch(demoText("Email reminders", "邮件提醒"), true)).
Add(demoText("About", "关于"), el.ViewFunc(func(*el.Context) el.Element {
return el.Text(demoText("Keel component examples 1.0", "Keel 组件示例 1.0"))
}))
tabs.Closable(tabs.Remove).Reorderable(nil).Trailing(kit.Button(demoText("Add", "新增"), func() { tabs.Add(demoText("New tag", "新标签"), kit.Input(demoText("Content", "内容"))) }).Variant(kit.ButtonGhost))
variants := []*kit.TabsView{}
for _, variant := range []kit.TabsVariant{kit.TabsUnderline, kit.TabsPill, kit.TabsOutline, kit.TabsSegmented} {
variants = append(variants, kit.Tabs().Variant(variant).AddItem(kit.TabItem{Title: demoText("Overview", "概览"), Icon: kit.IconHome}).AddItem(kit.TabItem{Title: demoText("Message", "消息"), Icon: kit.IconInbox, Content: el.ViewFunc(func(*el.Context) el.Element {
return el.Div().Row().Gap(theme.SpaceSm).Child(el.Text(demoText("Message", "消息")), el.Text("3").Bold())
})}).AddItem(kit.TabItem{Title: demoText("Disabled", "已禁用"), Icon: kit.IconLock, Disabled: true}))
}
scrolling := kit.Tabs().Scrollable(true).MaxWidth(100).Variant(kit.TabsPill)
for i := range 12 {
scrolling.Add(fmt.Sprintf(demoText("Document %02d", "文档 %02d"), i+1), nil)
}
scrolling.Trailing(kit.Button(demoText("Last item", "最后一项"), func() { scrolling.ScrollTo(scrolling.Len() - 1) }).Compact(true))
return el.Embed(el.ViewFunc(func(cx *el.Context) el.Element {
out := el.Div().P(24).Gap(theme.SpaceXl).W(el.Dp(460)).MaxW(el.Full).Child(tabs.Render(cx))
for i, v := range variants {
out.Child(el.Text([]string{demoText("Underline", "下划线"), demoText("Pill", "胶囊"), demoText("Tinted", "着色"), demoText("Segmented", "分段")}[i]).TextColor(theme.Muted), v.Render(cx))
}
out.Child(el.Text(demoText("Horizontal scrolling · Labels limited to 100dp", "横向滚动 · 标签宽度上限 100dp")).TextColor(theme.Muted), scrolling.Render(cx))
return out
}))
})
}
支持下划线、胶囊、着色和分段外观的标签页;所有变体都无边框。
tabs := kit.Tabs().Add("基本", basicForm).Add("通知", notifySettings).OnChange(onTab)
Variant(TabsUnderline/TabsPill/TabsOutline/TabsSegmented)选择外观,默认保留下划线样式。TabsOutline为兼容保留,现表示无边框着色标签。颜色随主题切换。AddItem(TabItem{Title, Page, Icon, Content, Disabled})添加图标或富标签。Content 替换可见标题,应为展示元素;Title 仍用于 Agent 名称和溢出菜单。富标签在有限宽度内布局,文字截断需内容自行设置 MaxLines。SetItem(i, item)更新条目并保留稳定身份;SetItemDisabled(i, bool)单项禁用。禁用项不能点击、关闭或拖动,方向键及溢出菜单跳过它。禁用当前项自动选择下一个可用项;全部禁用时保留当前页,标签不进入 Tab 导航,页面内容仍保留可用。重新启用一个条目后恢复选择。程序修改不触发 OnChange;SetValue 不选择禁用项。- 只渲染当前页。每一页都是应用自己持有的 View,切换后状态还在。
- Tab 键聚焦到当前标签,← → 切换,首尾循环,Home / End 跳到首尾。
- 标签放不下时,多出来的收进末尾的"更多"菜单,当前选中的标签始终保留在栏内,可继续用方向键操作;长标题会截断。和 Toolbar 一样,标签页要放在有宽度约束的位置。
Closable(fn)给每个标签加关闭按钮,fn(i)决定关闭的含义,通常直接传tabs.Remove。关闭按钮在标签旁边而不在标签里面,所以点击它不会先切换到这个标签。Reorderable(fn)允许拖动可见标签重排,放开指针后提交;取消拖动不改变顺序。Move(from, to)可程序重排任意标签,不触发回调;页面与编辑状态跟随稳定身份,选中页保持不变。拖动不自动打开溢出菜单。- 标签聚焦时 Delete 调用关闭回调。关闭当前页后,焦点移到剩余的相邻标签;关闭其他页保持当前页。
Leading(el.View)/Trailing(el.View)放置固定的左右区域;Size(dp)设置标签高度,默认 40,最小 24。SetDisabled禁用标签、关闭按钮、拖动和当前页。MaxWidth(dp)限制单个标签区域宽度(含图标和内边距,不含旁边的关闭按钮);0 取消上限,负数和非有限值忽略。默认文字自动省略,富内容自行设置截断。Scrollable(true)改为横向滚动标签栏,全部标签保留在轨道中,不再收进溢出菜单;固定 Leading/Trailing 不参与滚动。选中项变化后自动滚入视口,键盘焦点等滚动完成后转移。切回 false 恢复原溢出菜单行为。ScrollTo(i)请求显示某项,不改变选中项或触发回调;可在首次布局前调用,请求跟随标签身份。ScrollState(cx)返回最近绘制时的横向偏移、视口宽度、内容宽度,单位 dp。手动滚动不会被当前选中项强制拉回。Value()/SetValue(i)(不触发回调)、Remove(i)、Len()。
Agent:标签栏是 tablist,每个标签是 tab,selected 表示当前标签;当前页是以标签标题为名的 tabpanel。
验证:go run ./examples/components -section tabs,加 -theme dark 检查深色。