用途:该技能用于在页面中创建标签页(Tab)内容区域,由 <sgds-tab-group> 统一协调 <sgds-tab>(标签导航)与 <sgds-tab-panel>(标签内容)三类组件。
主要能力:<sgds-tab> 需置于 slot="nav" 槽位,并通过 panel 属性与某个 <sgds-tab-panel> 的 name 属性精确匹配,从而建立标签与内容的关联。在 <sgds-tab-group> 上可设置 variant(underlined 为默认、solid)、orientation(horizontal 为默认、vertical)、density(default、compact),这些属性会自动传播到所有子 <sgds-tab>。<sgds-tab> 支持 active(初始激活)和 disabled(禁止选择);<sgds-tab-panel> 的 name 为必填。
使用方式:如资料所示,在 <sgds-tab-group> 内先放入带 slot="nav" 的 <sgds-tab>,再放入对应的 <sgds-tab-panel> 即可。初始激活可通过在某个 <sgds-tab> 上加 active 指定;若未指定,则默认选中第一个非禁用标签。可通过监听 sgds-tab-show 与 sgds-tab-hide 事件获知切换,事件 detail 中带有 name 字符串。示例代码保留如下: <sgds-tab-group variant="solid" density="compact"> <sgds-tab slot="nav" panel="tab1">Tab One</sgds-tab> <sgds-tab slot="nav" panel="tab2" active>Tab Two (starts active)</sgds-tab> <sgds-tab-panel name="tab1">Content for tab one.</sgds-tab-panel> <sgds-tab-panel name="tab2">Content for tab two.</sgds-tab-panel> </sgds-tab-group>
适用场景:需要在界面中呈现多段并列内容并支持点击切换的导航式布局,包括横向标签栏与纵向侧边标签。
限制:安装与框架集成(React 19+ 与 React ≤18、Vue、Angular)需参见 sgds-components-setup;组件不暴露自定义属性(custom properties)与 CSS parts,因此无法通过 CSS 修改样式;标签组没有公开方法。