陈年往事 · blog

使用 MDX 完成友链卡片的展示

474 words 2 min read #MDX#Astro#Components#FriendLink

这篇文章介绍如何在 MDX 内容中使用 FriendLinkCard 组件,快速展示站点名称、链接、头像和简介。

为什么使用友链卡片?

相比纯文本链接,友链卡片可以提供更清晰的结构:

  • 一眼看到站点名称与定位
  • 支持头像和背景图,识别度更高
  • 保持页面信息密度与阅读节奏

如果你在做个人博客、数字花园或资源页,这个组件很适合用于友情链接区块。

组件导入

在 MDX 文件中先导入组件:

import FriendLinkCard from '../../components/mdx/FriendLinkCard.astro';

基础示例

下面是一个使用数组批量渲染友链列表的示例。组件会按照数组顺序展示,并在桌面宽度下一行排列两个卡片。

带背景图示例

如果你希望某一张卡片更有视觉识别,可以在对应数组项里加上 backgroundImage

可用属性

组件支持以下属性:

  • items: 友链数组(必填),会按照数组顺序渲染为列表

每个 items 数组项支持以下字段:

  • name: 友链名称(必填)
  • url: 跳转链接(必填)
  • bio: 简介文案(可选)
  • avatar: 头像地址(可选)
  • backgroundImage: 背景图地址(可选)

当未提供 avatar 时,组件会自动使用名称首字母作为头像占位。

小提示

  • 建议 bio 保持简短,避免卡片高度过大
  • 外链会在新标签页打开,并带有安全属性
  • 背景图建议选择对比清晰、细节不过度复杂的图片

留言

关于这篇文章的留言。