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

> **For AI agents:** the complete documentation index is at [llms.txt](/docs/llms.txt). Append `.md` to any page URL for its markdown version.

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

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

## 用法

```mdx
<Card title="Quickstart" icon="rocket" href="/quickstart">
  Launch your docs in minutes.
</Card>
```

## 基础卡片

带标题的简单卡片：

<Card title="入门指南">
  在五分钟内设置你的第一个项目。
</Card>

```mdx
<Card title="Getting Started">
  Set up your first project in under five minutes.
</Card>
```

## 带图标的卡片

添加图标，让卡片更具视觉辨识度：

<Card title="文档" icon="book">
  浏览完整文档，了解所有功能。
</Card>

```mdx
<Card title="Documentation" icon="book">
  Explore our complete documentation to learn all features.
</Card>
```

## 带链接的卡片

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

<Card title="API 参考" icon="code" href="/cn/introduction">
  查看完整的 API 文档。
</Card>

```mdx
<Card title="API Reference" icon="code" href="/introduction">
  View the complete API documentation.
</Card>
```

## 带箭头的卡片

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

<Card title="快速开始" icon="github" href="/cn/quickstart" arrow={true}>
  查看源代码并参与贡献。
</Card>

```mdx
<Card title="Quickstart" icon="github" href="/quickstart" arrow={true}>
  Check out the source code and contribute.
</Card>
```

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

<Card title="外部资源" href="https://example.com">
  此卡片链接到外部网站。
</Card>

```mdx
<Card title="External Resource" href="https://example.com">
  This card links to an external site.
</Card>
```

## 带 CTA 的卡片

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

<Card title="快速开始" icon="star" href="/cn/quickstart" cta="立即升级">
  解锁高级功能并获得优先支持。
</Card>

```mdx
<Card title="Quickstart" icon="star" href="/quickstart" cta="Upgrade now">
  Unlock advanced features and priority support.
</Card>
```

组合箭头和 CTA，以实现更醒目的效果：

<Card title="快速开始" icon="rocket" href="/cn/quickstart" arrow={true} cta="开始构建">
  启动第一个项目所需的一切。
</Card>

```mdx
<Card title="Quickstart" icon="rocket" href="/quickstart" arrow={true} cta="Start building">
  Everything you need to launch your first project.
</Card>
```

## 带图片的卡片

在卡片顶部显示图片：

<Card title="视觉指南" img="/images/card-example-1.webp">
  带有图片标题区域的卡片。
</Card>

```mdx
<Card title="Visual Guide" img="/images/card-example.webp">
  A card featuring an image header.
</Card>
```

## 使用 Columns 构建卡片网格

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

<Columns cols={2}>
  <Card title="快速开始" icon="rocket" href="/cn/quickstart">
    几分钟内即可开始运行。
  </Card>
  <Card title="教程" icon="graduation-cap" href="/cn/content/mdx-basics">
    分步学习路径。
  </Card>
  <Card title="示例" icon="flask" href="/cn/components/overview">
    真实场景的代码示例。
  </Card>
</Columns>

```mdx
<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>
```

### 三列布局

<Columns cols={3}>
  <Card title="文档" icon="book">
    文档
  </Card>
  <Card title="API" icon="code">
    API 参考
  </Card>
  <Card title="博客" icon="newspaper">
    最新更新
  </Card>
</Columns>

```mdx
<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

<ParamField name="title" type="string" required>
  显示在卡片顶部的标题。
</ParamField>

<ParamField name="icon" type="string">
  Font Awesome 图标名称（例如 "book"、"code"、"rocket"）。默认以 Solid 变体渲染；添加类似 `light/book` 的样式前缀可更改字重。请参阅 [图标](/cn/content/icons)。
</ParamField>

<ParamField name="href" type="string">
  卡片链接到的 URL。可以是内部 URL（`/docs/intro`）或外部 URL（`https://example.com`）。
</ParamField>

<ParamField name="img" type="string">
  显示在卡片顶部的图片路径。
</ParamField>

<ParamField name="arrow" type="boolean">
  在右上角显示箭头指示器（↗）。外部链接（以 `http://` 或 `https://` 开头的 URL）会自动启用。设置为 `true` 可在内部链接上显示，设置为 `false` 可在外部链接上隐藏。
</ParamField>

<ParamField name="cta" type="string">
  显示在卡片内容下方的自定义行动号召文本。仅当同时提供 `href` 时可见。
</ParamField>

## Columns Props

<ParamField name="cols" type="number" default="2">
  网格中的列数。可接受 1、2、3 或 4。
</ParamField>

## 下一步

<Columns cols={2}>
  <Card title="组件概览" icon="puzzle-piece" href="/cn/components/overview">
    浏览所有可用组件
  </Card>
  <Card title="MDX 基础" icon="file-code" href="/cn/content/mdx-basics">
    了解如何在 MDX 中使用组件
  </Card>
</Columns>

```