---
title: Cartão
description: >-
  Aprenda a usar o componente Card para criar contêineres estilizados e clicáveis com ícones, imagens, links e CTAs em layouts de grade.
---

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

O componente `<Card>` é um contêiner estilizado e clicável. Use-o para criar links para outras páginas ou agrupar conteúdo relacionado. Combine cartões com `<Columns>` para criar layouts de grade.

As capturas de tela mostram a interface em inglês.

## Uso

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

## Cartão básico

Um cartão simples com título:

<Card title="Primeiros passos">
  Configure seu primeiro projeto em menos de cinco minutos.
</Card>

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

## Cartão com ícone

Adicione um ícone para tornar os cartões mais distintos visualmente:

<Card title="Documentação" icon="book">
  Explore nossa documentação completa para conhecer todos os recursos.
</Card>

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

## Cartão com link

Os cartões podem direcionar para outras páginas:

<Card title="Referência da API" icon="code" href="/pt/introduction">
  Consulte a documentação completa da API.
</Card>

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

## Cartão com seta

Adicione um indicador de seta para mostrar que o cartão direciona para algum lugar. As setas aparecem automaticamente em links externos, mas você também pode ativá-las para links internos:

<Card title="Primeiros passos" icon="github" href="/pt/quickstart" arrow={true}>
  Confira o código-fonte e contribua.
</Card>

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

Links externos mostram a seta automaticamente:

<Card title="Recurso externo" href="https://example.com">
  Este cartão direciona para um site externo.
</Card>

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

## Cartão com CTA

Adicione um texto de chamada para ação abaixo do conteúdo do cartão:

<Card title="Primeiros passos" icon="star" href="/pt/quickstart" cta="Atualize agora">
  Desbloqueie recursos avançados e suporte prioritário.
</Card>

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

Combine a seta e a CTA para dar o máximo de destaque:

<Card title="Primeiros passos" icon="rocket" href="/pt/quickstart" arrow={true} cta="Comece a criar">
  Tudo o que você precisa para iniciar seu primeiro projeto.
</Card>

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

## Cartão com imagem

Exiba uma imagem na parte superior do cartão:

<Card title="Guia visual" img="/images/card-example-1.webp">
  Um cartão com cabeçalho de imagem.
</Card>

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

## Grade de cartões com Columns

Use `Columns` para organizar vários cartões em uma grade responsiva:

<Columns cols={2}>
  <Card title="Primeiros passos" icon="rocket" href="/pt/quickstart">
    Comece a usar em poucos minutos.
  </Card>
  <Card title="Tutoriais" icon="graduation-cap" href="/pt/content/mdx-basics">
    Percursos de aprendizagem passo a passo.
  </Card>
  <Card title="Exemplos" icon="flask" href="/pt/components/overview">
    Exemplos de código do mundo real.
  </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>
```

### Layout de três colunas

<Columns cols={3}>
  <Card title="Docs" icon="book">
    Documentação
  </Card>
  <Card title="API" icon="code">
    Referência da API
  </Card>
  <Card title="Blog" icon="newspaper">
    Atualizações recentes
  </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>
```

## Propriedades

<ParamField name="title" type="string" required>
  O título exibido na parte superior do cartão.
</ParamField>

<ParamField name="icon" type="string">
  Nome do ícone do Font Awesome (por exemplo, "book", "code", "rocket"). Por padrão, é renderizado na variante Solid; adicione um prefixo de estilo, como `light/book`, para alterar o peso. Consulte [Ícones](/pt/content/icons).
</ParamField>

<ParamField name="href" type="string">
  URL para a qual o cartão direciona. Pode ser interna (`/docs/intro`) ou externa (`https://example.com`).
</ParamField>

<ParamField name="img" type="string">
  Caminho para uma imagem exibida na parte superior do cartão.
</ParamField>

<ParamField name="arrow" type="boolean">
  Exibe um indicador de seta (↗) no canto superior direito. É ativado automaticamente para links externos (URLs que começam com `http://` ou `https://`). Defina como `true` para exibi-lo em links internos ou como `false` para ocultá-lo em links externos.
</ParamField>

<ParamField name="cta" type="string">
  Texto personalizado de chamada para ação exibido abaixo do conteúdo do cartão. Só fica visível quando `href` também é fornecido.
</ParamField>

## Propriedades de Columns

<ParamField name="cols" type="number" default="2">
  Número de colunas na grade. Aceita 1, 2, 3 ou 4.
</ParamField>

## O que vem a seguir?

<Columns cols={2}>
  <Card title="Visão geral dos componentes" icon="puzzle-piece" href="/pt/components/overview">
    Navegue por todos os componentes disponíveis
  </Card>
  <Card title="Fundamentos de MDX" icon="file-code" href="/pt/content/mdx-basics">
    Aprenda a usar componentes em MDX
  </Card>
</Columns>