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"覆盖自动图标
属性说明
| 属性 | 类型 | 说明 |
|---|---|---|
text | string | 显示文本 |
link | string | 链接地址,支持内部和外部链接 |
img | string | 自定义图片 URL,覆盖自动图标 |
round | boolean | 强制圆形样式 |
square | boolean | 强制方形样式 |
样式规则:
- 有图时默认圆形,指定
square改为方形 - 无图时默认方形,指定
round改为圆形
在文本中使用
Badge 可以自然地嵌入段落文本中:这是一段关于 VitePress 的介绍,它使用了
Vue 和
markdown-it。
与其他标签组合
Badge 可以和 ProseA 链接、自定义文本标签等其他外挂标签一起使用:
- ProseA 智能链接搭配
GitHub
- 变大变高搭配 标签
组件源码
组件位于 .vitepress/theme/components/Tags/Badge.vue,通过 unplugin-vue-components 自动注册,无需手动 import。
赞赏博主
关注博主 评论 隐私政策