通用组件
主题在 config/.vitepress/theme/index.ts 中注册了以下通用组件。
GenericBadge
通用徽章,支持自定义图标、文字和队伍主题色。
Props
| Prop | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
icon | string | 否 | - | 图标图片路径,例如 /resources/logos/scp_foundation.png |
text | string | 是 | - | 徽章文字 |
team | string | 否 | not-set | 队伍 key,用于读取 :root 中的 --team-* 颜色变量 |
预览
基金会代码
md
<GenericBadge text="基金会" icon="/resources/logos/scp_foundation.png" team="mtf-guards" />TeamText
将 slot 内容渲染为指定队伍的文字颜色。
Props
| Prop | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
team | string | 是 | - | 队伍 key,例如 scps、mtf-guards |
预览
SCP 文字示例代码
md
<TeamText team="scps">SCP 文字示例</TeamText>TeamBadge
将 slot 内容渲染为指定队伍的徽章样式。
Props
| Prop | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
team | string | 是 | - | 队伍 key |
预览
混沌分裂者代码
md
<TeamBadge team="chaos-insurgency">混沌分裂者</TeamBadge>TeamCard
队伍身份卡片,包含图标、标题、标语和 Markdown 内容区。
Props
| Prop | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
title | string | 是 | - | 队伍名字 |
icon | string | 是 | - | 图标路径 |
team | string | 是 | - | 队伍 key |
slogan | string | 否 | - | 可选标语 |
iconSize | number | 否 | 256 | 图标尺寸(px) |
预览
混沌分裂者
突破收容,解放异常
示例Header
- 示例规则 1
- 示例规则 2
代码
md
<TeamCard title="混沌分裂者" icon="/resources/roles_icon/chaos.png" team="chaos-insurgency" slogan="突破收容,解放异常">
## 示例Header
- 示例规则 1
- 示例规则 2
</TeamCard>BadgeDisplayToggle
固定在导航栏右上角的按钮,用于切换所有徽章的纯文字/完整显示模式。该组件由主题自动挂载,文档中通常不需要手动使用。
预览
该组件已在当前页面右上角生效,可点击切换徽章显示模式。
