该组件可以帮助您创建标签页式的界面,以便更高效地显示相关信息。当有不同的方式来完成同一件事情时,请使用它:
- 仪表板 / API / Terraform
- 不同的代码语法样式
- 账户级别与区域(zone)级别的导航
- GRE / IPsec 隧道
主要答案或核心说明应始终出现在主要内容流中,而不应仅存在于选项卡或可折叠区域内。
只有在阐述了通用概念之后,才能针对特定平台的变化(例如,仪表板对比 API 对比 Terraform)使用选项卡。使用 Details 提供补充信息,而不是用于主要答案。
import { Tabs, TabItem } from "~/components";
<Tabs>
<TabItem label="Stars" icon="ph:star">
Sirius, Vega, Betelgeuse
</TabItem>
<TabItem label="Moons" icon="ph:moon">
Io, Europa, Ganymede
</TabItem>
</Tabs>(可选)您可以从 Starlight 的 Icons ↗ 中为 tab labels 选择一个对应的图标。
如果您的标签页遵循特定模式(仪表板 / API / Terraform),请添加包含 string 值的 syncKey 参数。
我们在文档中使用以下 syncKey 值:
dashPlusAPI:仪表板 / API / TerraformworkersExamples:用于 Workers 文档中的不同代码语言标签页(JavaScript、TypeScript、Python、Rust)
import { Tabs, TabItem } from "~/components";
<Tabs syncKey="dashPlusAPI"> <TabItem label="Dashboard">
Dash instructions
</TabItem> <TabItem label="API">
API instructions
</TabItem> </Tabs>将与此同步:
Dash instructions
API instructions