Keel v0.5.1 English GitHub

Tabs

在线示例:这是真实的 Keel 程序编译成 WebAssembly,可以直接操作。首次加载约 10 MB。全屏打开
示例代码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 检查深色。