Skip to content
Mintlify
Mintlify
组件

卡片

使用卡片组件以可视化容器的形式展示链接、图标、图片和分组内容,从而组织导航。

使用卡片为内容创建可视化容器。卡片是一种灵活的容器,可以包含文本、图标、图片和链接。

卡片标题

这是带有图标和链接的卡片用法。点击此卡片 将跳转到 Columns 页面。

Card example
<Card title="卡片标题" icon="text-align-start" href="/zh/components/columns">
  这是使用带有图标和链接的卡片的示例。点击此卡片会跳转到列组件页面。
</Card>

卡片支持多种布局和样式选项,可满足不同的内容需求。

添加 horizontal 属性,以更紧凑的水平布局显示卡片。

水平卡片

这是一个水平卡片示例。

Horizontal card example
<Card title="横向卡片" icon="text-align-start" horizontal>
  这是横向卡片的示例。
</Card>

添加一个 img 属性即可在卡片顶部显示图片。

图片卡片

这是一个带图片的卡片示例。

Image card example
<Card title="图片卡片" img="/images/card-with-image.png">
  这是一个带图片的卡片示例。
</Card>

你可以自定义号召性用语的文本,并控制是否显示箭头。默认情况下,箭头只会显示在外部链接上。

链接卡片

这是一个带有图标和链接的卡片示例。点击此卡片会将你带到 Columns 页面。

点击这里
Link card example
<Card
  title="链接卡片"
  icon="link"
  href="/zh/components/columns"
  arrow="true"
  cta="点击这里"
>
  这是一个带有图标和链接的卡片示例。点击此卡片可跳转到列组件页面。
</Card>

添加 type 属性,可以让卡片应用与 callout 相同的主题样式。类型化卡片会带有与所选类型相匹配的彩色背景、边框和默认图标。使用它们来突出显示分组内容,例如说明、警告或成功状态。

支持的类型:infowarningnotetipcheckdanger。你也可以使用 icon 属性覆盖默认图标。

说明卡片

使用 note 来突出显示补充信息。

警告卡片

使用 warning 来标记潜在问题。

提示卡片

使用 tip 来分享有用的建议。

危险卡片

使用 danger 来表示破坏性或有风险的操作。

Typed card example
<Card title="说明卡片" type="note">
  使用 `note` 来突出显示补充信息。
</Card>

<Card title="警告卡片" type="warning">
  使用 `warning` 来标记潜在问题。
</Card>

使用 Columns 组件 将多个卡片并排展示。Columns 组件支持 1 到 4 列,并会自动适配小屏幕。

第一张卡片

这是第一张卡片。

第二张卡片

这是第二张卡片。

Columns example
<Columns cols={2}>
  <Card title="第一张卡片" icon="panel-left-close">
    这是第一张卡片。
  </Card>
  <Card title="第二张卡片" icon="panel-right-close">
    这是第二张卡片。
  </Card>
</Columns>
titlestring

显示在卡片上的标题。

iconstring

要显示的图标。

可选值:

  • Font Awesome 图标名称 (如果你在 docs.json 中将 icons.library 属性 设置为 fontawesome)
  • Lucide 图标名称 (如果你在 docs.json 中将 icons.library 属性 设置为 lucide)
  • Tabler 图标名称 (如果你在 docs.json 中将 icons.library 属性 设置为 tabler)
  • 指向外部托管图标的 URL
  • 项目中图标文件的路径
  • 用花括号包裹的 SVG 代码

对于自定义 SVG 图标:

  1. 使用 SVGR 转换器 转换你的 SVG。
  2. 将 SVG 代码粘贴到 SVG 输入框。
  3. 从 JSX 输出框中复制完整的 <svg>...</svg> 元素。
  4. 用花括号包裹可用于 JSX 的 SVG 代码:icon={<svg ...> ... </svg>}
  5. 根据需要调整 heightwidth
iconTypestring

Font Awesome 的图标样式。仅在使用 Font Awesome 图标时生效。

可选值:regularsolidlightthinsharp-solidduotonebrands

colorstring

图标颜色,使用十六进制色值 (例如 #FF6B6B) 。

hrefstring

卡片被点击时跳转到的 URL。

horizontalboolean

以紧凑的横向布局显示卡片。

imgstring

在卡片顶部显示的图片 URL 或本地路径。

ctastring

操作按钮的自定义文本。

arrowboolean

是否显示链接箭头图标。

typestring

为卡片应用 callout 风格的主题。可选值为 infowarningnotetipcheckdanger。会将卡片的背景、边框和默认图标设置为与所选类型相匹配。

Was this page helpful?Suggest editsRaise issue