# TabHeader 多标签页头

`AntdUI.TabHeader` 是独立的多标签页头控件，继承 `PageHeader`。它只负责标签头的展示、选中、关闭和添加，内容区域需要你自己切换。

## 最小示例

```aardio
import win.ui;
import dotNet.AntdUI;
/*DSG{{*/
var winform = win.form(text="AntdUI TabHeader";right=760;bottom=320)
winform.add(host={cls="custom";left=0;top=0;right=760;bottom=320;db=1;dl=1;dr=1;dt=1;z=1})
/*}}*/

var tab = AntdUI.TabHeader(winform.host);
tab.Text = "工作台";
tab.ShowAdd = true;
tab.DragSort = true;
tab.AddTab("首页");
tab.AddTab(AntdUI.TagTabItem("订单"),true);
tab.AddTab(AntdUI.TagTabItem("设置").SetBadge("3"));

tab.AddClick = function(sender,e){
    tab.AddTab("新标签",,true);
}

tab.TabChanged = function(sender,e){
    // 根据 e.Index 或 e.Value 切换下方内容区
}

tab.TabClosing = function(sender,e){
    // 如需阻止关闭，按上游事件参数能力设置取消标记
}

winform.show();
win.loopMessage();
```

## 常用属性、方法与事件

| 成员 | 说明 |
| --- | --- |
| `Items` | 标签集合，元素为 `AntdUI.TagTabItem`。 |
| `SelectedIndex` / `SelectedItem` | 当前选中标签。 |
| `ShowAdd` | 是否显示新增按钮。 |
| `DragSort` | 是否允许拖拽排序。 |
| `Radius` / `RadiusContent` | 标签与内容圆角。 |
| `ForeActive` / `BackActive` | 激活态颜色。 |
| `AddTab(text)` / `AddTab(item,select)` | 添加标签。 |
| `InsertTab(index,item,select)` | 插入标签。 |
| `RemoveTab(index)` | 删除标签。 |
| `Select(item)` | 选中标签。 |
| `AddClick` | 点击新增按钮事件。 |
| `TabChanged` / `TabSelectedItemChanged` | 选中项变化事件。 |
| `TabClosing` | 标签关闭前事件。 |

## TagTabItem 常用属性

| 属性 | 说明 |
| --- | --- |
| `Text` | 标签文字。 |
| `Icon` / `IconSvg` | 标签图标。 |
| `ShowClose` | 是否显示关闭按钮。 |
| `Loading` | 加载状态。 |
| `Badge` / `BadgeSvg` | 徽标。 |
| `BadgeAlign` / `BadgeSize` | 徽标位置与大小。 |
| `Tag` | 自定义数据。 |

## 注意事项

- `TabHeader` 不是完整标签页容器；如果你需要自动管理页面内容，可优先查看 `Tabs` 组件。
- `AddTab("新标签",,true)` 这种调用保留了第二个可选参数位置，用第三个参数指定是否选中。