直接跳到内容

TabbedContent / TabPane 标签页容器

TabbedContent 是一个内置标签导航栏的容器组件,配合 TabPane 子组件可快速构建多标签页界面。用户点击不同标签即可切换显示对应的内容区域。

底层:Textual TabbedContent

基本用法

Props

TabbedContent Props

属性类型默认值说明
initialstr""初始激活的 TabPane 的 id;留空则激活第一个 TabPane

TabPane Props

属性类型默认值说明
titlestr必填标签页标题,显示在标签导航栏上
idstr自动生成标签页唯一标识,用于 initial 属性或编程式切换

v-model

  • TabbedContent v-model 默认绑定属性:active(当前激活标签的 ID)
  • TabPane v-model 默认绑定属性:label(标签文字)

通过 v-model 可以读取或控制当前激活的标签:

事件

事件参数说明
@tabbed_content_tab_activatedTabbedContent.TabActivated用户切换到新标签时触发;event.tab 为被激活的 Tab 对象

事件使用示例

进阶示例

动态标签内容

结合响应式数据动态渲染标签页内容:

通用属性

所有 Textual-vuepy 组件均支持以下属性:

属性类型说明
idstr组件 CSS ID,可通过 #id 选择器引用
stylestrTCSS 内联样式,多条规则用分号分隔
classstrTCSS 类名,多个类名用空格分隔
border_titlestr边框标题(需组件设置了 border 样式才可见)
border_subtitlestr边框副标题
TabbedContent / TabPane 标签页容器已经加载完毕