这篇文章测试 Tabs 标签页。使用 tabs 代码块,多个面板用 --- tab: 标题 分隔。样式与 FixIt 演示站一致:每个类型只保留自己的边框语言,active 一律用主题主色标记。
基本用法
默认是 type=underline placement=top,一行文字按钮 + 底部 2px 分隔线,active 变主题色。
这是 underline 类型,默认 placement=top,defaultTab=0。
Tab 内容支持 Markdown:段落、列表、代码等。
这是第二个 tab。点击上方的按钮切换。
分隔线下方就是当前面板,直接展开内容,不加盒。
四种类型
Underline(默认)
文字按钮 + 2px 分隔线,active 主题蓝。
分隔线就是它的"边框"——一条线,不围盒子。
Pill 胶囊
每个胶囊带 1px 边框,active 主题色填充白字。
胶囊适合短标签,可自动换行堆叠。
active 是实心主色,其余是描边透明。
Card 卡片
唯一带盒子的类型:连接式卡片壳,active 按钮与面板边框融合。
卡片壳 + 圆角 + 表面底色,active 按钮与面板融合成一体。
这是卡片风格的第二张,边框闭合,按钮连着面板。
Segment 分段
灰色轨道 + 边框,active 是浮起的白色块。
console.log("hello tabs");这是一段预览内容。
- 列表项 1
- 列表项 2
放置方向
底部(placement=bottom)
分隔线跑到面板下方,先看内容再切换。
底部导航的按钮仍然是主题蓝 active。
左侧(placement=left)
Pill 类型,tab 放在左侧,按钮竖直排列。
适合 tab 标题较长、横向放不下的情况。
右侧(placement=right)
默认选中第二个 tab(defaultTab=1)。
卡片风格,tab 在右侧,默认打开这个面板。
验证点:页面加载后应看到这个面板,另一个隐藏。
默认选中
default=1 让第二个面板默认打开。
这个默认隐藏。
default=1 让它默认可见。
嵌套
tab 内容里可以继续嵌套其他组件:Admonition、代码块等。
[!TIP] Tabs 内容里可以放 Admonition!
正常段落文字,验证嵌套生效。
[!INFO] Tabs 和 Admonition 可以任意嵌套。
外层用 4 个反引号,tab 内容里就可以继续写普通 3 反引号代码块。
const tabs = document.querySelectorAll(".article-tabs");键盘与无障碍
- 点击或方向键切换(
←/→、Home/End) role=tablist / tab / tabpanel,aria-selected跟随状态- 焦点在 tab 上时方向键不会触发文章级快捷键(不会翻到下一篇)
评论
GitHub 登录后可评论。
评论区会在滚动到这里时自动加载。