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 的介绍,它使用了 Vuemarkdown-it

与其他标签组合

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

组件源码

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

赞赏博主
评论 隐私政策