Tab

自 2.2.1

Tab 是一个单独的选项卡头部元素。它显示一个文本标签，并根据其处于空闲、悬停或选中状态而改变背景纹理。选项卡通常在 TabView 中管理，由 TabView 处理选择逻辑。

INFO

UIElement 中记录的所有内容（布局、样式、事件、数据绑定等）同样适用于此处。

---

用法

选项卡通常与 TabView 一起创建：

var tabView = new TabView();

var tab1 = new Tab().setText("Settings");
var tab2 = new Tab().setText("Info");

tabView.addTab(tab1, new UIElement()); // 选项卡 + 其内容面板
tabView.addTab(tab2, new UIElement());
parent.addChild(tabView);

tabView({ }) {
    tab("Settings") { /* 在此处添加设置内容子元素 */ }
    tab("Info") { /* 在此处添加信息内容子元素 */ }
}

---

XML

<tab-view>
    <tab text="Settings">
        <tab-content>
            <!-- 设置面板的子元素放在此处 -->
        </tab-content>
    </tab>
    <tab text="Info">
        <tab-content>
            <!-- 信息面板的子元素放在此处 -->
        </tab-content>
    </tab>
</tab-view>

INFO

Tab 通常作为 <tab-view> 的直接 XML 子元素放置。<tab-content> 元素指定与此选项卡关联的内容面板。

XML 属性	类型	描述
text	string	标签文本（字面量，不进行翻译）。

---

内部结构

索引	字段	CSS 类	描述
0	text	.__tab_text__	显示选项卡文本的 Label 元素。

---

Tab 样式

TabStyle 采用与 Button 相同的三态纹理系统，但三种状态分别对应空闲、悬停和选中。

INFO

base-background

选项卡处于空闲状态（未选中，未悬停）时的背景。

默认值：Sprites.TAB_DARK

tab.tabStyle(style -> style.baseTexture(myIdleTexture));

tab {
    base-background: sprite("mymod:textures/gui/tab_idle.png");
}

INFO

hover-background

鼠标悬停在选项卡上时的背景。

默认值：Sprites.TAB_WHITE

tab.tabStyle(style -> style.hoverTexture(myHoverTexture));

tab {
    hover-background: sprite("mymod:textures/gui/tab_hover.png");
}

INFO

pressed-background

选项卡被选中时的背景（pressed-background 属性被复用于选中状态）。

默认值：Sprites.TAB

tab.tabStyle(style -> style.selectedTexture(mySelectedTexture));

tab {
    pressed-background: sprite("mymod:textures/gui/tab_selected.png");
}

---

CSS 状态

当选项卡被选中时，它会获得 CSS 类 .__tab_selected__。关联的内容元素会获得 .__tab_content_selected__。

---

字段

名称	类型	访问权限	描述
text	Label	public final	标签元素。
tabStyle	TabStyle	private (getter)	当前选项卡样式。

---

方法

方法	返回	描述
setText(String)	Tab	设置标签文本（字面量）。
setText(String, boolean)	Tab	设置标签文本。true = 可翻译。
setText(Component)	Tab	从 Component 设置标签。
setDynamicText(Supplier<Component>)	Tab	将标签绑定到数据提供器以进行实时更新。
textStyle(Consumer<TextElement.TextStyle>)	Tab	流畅地配置标签的文本样式。
tabStyle(Consumer<TabStyle>)	Tab	流畅地配置 TabStyle。
setOnTabSelected(Runnable)	—	此选项卡被选中时调用的回调。
setOnTabUnselected(Runnable)	—	此选项卡被取消选中时调用的回调。
getContent()	UIElement (nullable)	返回父级 TabView 中的内容面板。
getTabView()	TabView (nullable)	返回父级 TabView。