跳转到内容

Tabs:标签页选择器

Tabs 构建标签页选择器。本页包含可运行示例、完整属性及行为限制。

完整示例

先完成环境准备。下面是完整 main.go,执行 go run .

go
package main

import (
	"github.com/dxui-org/dxui"
	"log"
)

func main() {
	value := "home"
	app := dxui.NewApp(dxui.AppOptions{
		Title:      "Tabs",
		Width:      640,
		Height:     480,
		Background: dxui.RGBA(248, 250, 252, 255),
	})
	if err := app.Run(func() dxui.View {
		return dxui.Box(
			dxui.BoxProps{
				Gap: 16,
				Style: dxui.Style{
					Padding: dxui.Padding(24),
				},
			},
			dxui.Box(
				dxui.BoxProps{
					Gap: 12,
				},
				dxui.Tabs(dxui.TabsProps{
					Value:    value,
					OnChange: dxui.Assign(&value),
					Items: []dxui.TabItem{
						{
							Value: "home",
							Label: "Home",
						},
						{
							Value: "settings",
							Label: "Settings",
						},
					},
				}),
				dxui.Label("Panel: "+value),
			),
		)
	}); err != nil {

		log.Fatal(err)
	}
}

参数与 API

go
func Tabs(props TabsProps) View
字段类型用途、默认与约束
Keystring同父级稳定唯一身份;默认空。动态列表使用业务 ID,勿用可变索引。
StyleStyle局部布局、绘制和文本样式;零值使用固有尺寸与主题默认。
TokenComponentToken组件主题条目;空值选择该组件默认。
StatesStateStyles真实交互状态的绘制补丁,不能伪造状态或改变布局。
PointerPointerBehavior默认 PointerAuto;PointerNone 排除整个子树的指针参与,不等同 Disabled。
Valuestring应用拥有的当前值;行为、范围和零值见本页说明。
Items[]TabItem复制的 TabItem/MenuItem 列表;值非空唯一,允许空列表。
Disabledbool默认 false;交互组件为 true 时移除焦点并取消交互。
OnChangefunc(string)完整新值提案;写回业务变量后下一次构建生效。nil 行为见本页。

行为与边界

只渲染横向标签,内容面板由应用依据 Value 构建。Items.Value 必须非空且唯一;空/未匹配 Value 不显示选中指示。左右/Home/End 移动内部当前项,Enter/Space 才提案;已选中或 Disabled 项不回调。没有 TabPanel、垂直、滚动、关闭或拖拽排序 API。

所有组件共享身份、样式与指针规则。字段引用的枚举、结构体及源码注释见完整声明参考示例运行方式包含构建验证方法。