AI 摘要

本摘要由 AI 生成,仅供参考,内容请以原文为准。

Badge 徽章标签组件 ​

本站提供 <Badge> 组件,用于在文章中嵌入带图标的小标签。组件自动识别外部链接的站点图标和 GitHub 头像。

基本用法 ​

普通带链接 纯文本指定圆形 纯文本指定方形 带个图

语法:

md
<Badge text="普通带链接" link="#badge" />
<Badge text="纯文本指定圆形" round />
<Badge text="纯文本指定方形" square />
<Badge text="带个图" img="https://picsum.photos/100/100" />

自动图标 ​

外部域名自动获取站点图标 纸鹿,古怪杂记本,GitHub 链接能自动识别头像 KazariEX,也可指定方形 isYangs/GioPic。

语法:

md
<Badge text="纸鹿" link="https://www.zhilu.site" />
<Badge text="古怪杂记本" link="https://gug.thisis.host/" square />
<Badge text="KazariEX" link="https://github.com/KazariEX" />
<Badge text="isYangs/GioPic" square link="https://github.com/isYangs/GioPic" />

图标自动匹配规则:

  • GitHub 链接:自动获取用户/仓库头像(github.com/{user}.png)
  • 其他外部链接:通过 Google Favicon 服务获取站点图标
  • 手动指定:使用 img="url" 覆盖自动图标

属性说明 ​

属性类型说明
textstring显示文本
linkstring链接地址,支持内部和外部链接
imgstring自定义图片 URL,覆盖自动图标
roundboolean强制圆形样式
squareboolean强制方形样式

样式规则:

  • 有图时默认圆形,指定 square 改为方形
  • 无图时默认方形,指定 round 改为圆形

在文本中使用 ​

Badge 可以自然地嵌入段落文本中:这是一段关于 VitePress 的介绍,它使用了 Vue 和 markdown-it。

与其他标签组合 ​

Badge 可以和 ProseA 链接、自定义文本标签等其他外挂标签一起使用:

组件源码 ​

组件位于 .vitepress/theme/components/Tags/Badge.vue,通过 unplugin-vue-components 自动注册,无需手动 import。

赞赏博主
评论 隐私政策