Jamdesk Documentation logo

卡片

了解如何使用 Card 组件,在网格布局中构建包含图标、图片、链接和 CTA 的可点击样式容器。

<Card> 组件是可点击的样式容器。使用它链接到其他页面或组合相关内容。将卡片与 <Columns> 搭配使用可构建网格布局。

屏幕截图显示的是英文界面。

用法

<Card title="Quickstart" icon="rocket" href="/quickstart">

  Launch your docs in minutes.

</Card>

基础卡片

带标题的简单卡片:

入门指南

在五分钟内设置你的第一个项目。

<Card title="Getting Started">

  Set up your first project in under five minutes.

</Card>

带图标的卡片

添加图标,让卡片更具视觉辨识度:

文档

浏览完整文档,了解所有功能。

<Card title="Documentation" icon="book">

  Explore our complete documentation to learn all features.

</Card>

带链接的卡片

卡片可以链接到其他页面:

API 参考

查看完整的 API 文档。

<Card title="API Reference" icon="code" href="/introduction">

  View the complete API documentation.

</Card>

带箭头的卡片

添加箭头指示器,显示卡片会链接到其他位置。外部链接会自动显示箭头,但你也可以为内部链接启用箭头:

快速开始

查看源代码并参与贡献。

<Card title="Quickstart" icon="github" href="/quickstart" arrow={true}>

  Check out the source code and contribute.

</Card>

外部链接会自动显示箭头:

外部资源

此卡片链接到外部网站。

<Card title="External Resource" href="https://example.com">

  This card links to an external site.

</Card>

带 CTA 的卡片

在卡片内容下方添加行动号召文本:

快速开始

解锁高级功能并获得优先支持。

立即升级
<Card title="Quickstart" icon="star" href="/quickstart" cta="Upgrade now">

  Unlock advanced features and priority support.

</Card>

组合箭头和 CTA,以实现更醒目的效果:

快速开始

启动第一个项目所需的一切。

开始构建
<Card title="Quickstart" icon="rocket" href="/quickstart" arrow={true} cta="Start building">

  Everything you need to launch your first project.

</Card>

带图片的卡片

在卡片顶部显示图片:

视觉指南
视觉指南

带有图片标题区域的卡片。

<Card title="Visual Guide" img="/_jd/images/card-example.webp?v=mst25htz">

  A card featuring an image header.

</Card>

使用 Columns 构建卡片网格

使用 Columns 将多个卡片排列为响应式网格:

快速开始

几分钟内即可开始运行。

教程

分步学习路径。

示例

真实场景的代码示例。

<Columns cols={2}>
  <Card title="Quickstart" icon="rocket" href="/quickstart">

    Get up and running in minutes.

</Card>
  <Card title="Tutorials" icon="graduation-cap" href="/content/mdx-basics">

    Step-by-step learning paths.

</Card>
  <Card title="Examples" icon="flask" href="/components/overview">

    Real-world code examples.

</Card>

</Columns>

三列布局

文档

文档

API

API 参考

博客

最新更新

<Columns cols={3}>
  <Card title="Docs" icon="book">

    Documentation

</Card>
  <Card title="API" icon="code">

    API Reference

</Card>
  <Card title="Blog" icon="newspaper">

    Latest updates

</Card>
</Columns>

Props

stringrequired

显示在卡片顶部的标题。

string

Font Awesome 图标名称(例如 "book"、"code"、"rocket")。默认以 Solid 变体渲染;添加类似 light/book 的样式前缀可更改字重。请参阅 图标

string

卡片链接到的 URL。可以是内部 URL(/docs/intro)或外部 URL(https://example.com)。

string

显示在卡片顶部的图片路径。

boolean

在右上角显示箭头指示器(↗)。外部链接(以 http://https:// 开头的 URL)会自动启用。设置为 true 可在内部链接上显示,设置为 false 可在外部链接上隐藏。

string

显示在卡片内容下方的自定义行动号召文本。仅当同时提供 href 时可见。

Columns Props

numberdefault: 2

网格中的列数。可接受 1、2、3 或 4。

下一步

组件概览

浏览所有可用组件

MDX 基础

了解如何在 MDX 中使用组件