---
title: Bloco
description: Os blocos exibem prévias de conteúdo com fundo padronizado e uma área de imagem em destaque. Use-os para integrações, modelos ou galerias visuais.
---

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

Os blocos exibem prévias com imagens em destaque e fundos padronizados. Use-os em vez de Cards quando uma captura de tela ou um logotipo for mais importante que o texto: páginas de integração, galerias de modelos e páginas com muitas imagens.

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

Use blocos quando:
- **As prévias visuais** forem mais importantes que as descrições em texto
- **Apresentar integrações** com logotipos ou capturas de tela
- **Criar galerias** de modelos, temas ou exemplos
- **Exibir capturas de tela** com títulos e descrições opcionais

## Uso

```mdx
<Tile href="/components/tabs" title="Tabs Component">
  <img src="/images/tabs-preview.webp" alt="Tabs" />
</Tile>
```

## Bloco básico

Um bloco simples com imagem de prévia e título:

<Tile href="/pt/components/tabs" title="Componente Tabs">
  <img src="/images/tabs-preview.webp" alt="Tabs" />
</Tile>

```mdx
<Tile href="/components/tabs" title="Tabs Component">
  <img src="/images/tabs-preview.webp" alt="Tabs" />
</Tile>
```

## Bloco com descrição

Adicione uma descrição para fornecer mais contexto:

<Tile href="/pt/components/tabs" title="Componente Tabs" description="Organize o conteúdo em seções com abas alternáveis">
  <img src="/images/tabs-preview.webp" alt="Tabs" />
</Tile>

```mdx
<Tile
  href="/components/tabs"
  title="Tabs Component"
  description="Organize content into switchable tabbed sections"
>
  <img src="/images/tabs-preview.webp" alt="Tabs" />
</Tile>
```

## Bloco ou Card

| Recurso | Bloco | Card |
|---------|------|------|
| Ênfase visual | Imagem em destaque com fundo padronizado | Ícone + título + descrição |
| Melhor para | Integrações, modelos e galerias | Navegação, listas de recursos e CTAs |
| Tratamento de imagens | Área ampla de prévia | Ícone pequeno |
| Conteúdo de texto | Título + descrição opcional | Título + descrição + ícone |

**Regra geral:** se você tiver uma captura de tela ou um logotipo para exibir, use um bloco. Se o conteúdo for principalmente textual, use um Card.

## Layout em grade

Use `Columns` para exibir vários blocos em uma grade:

<Columns cols={3}>
  <Tile href="https://slack.com" title="Slack">
    <img src="/images/tabs-preview.webp" alt="Slack" />
  </Tile>
  <Tile href="https://github.com" title="GitHub">
    <img src="/images/tabs-preview.webp" alt="GitHub" />
  </Tile>
  <Tile href="https://stripe.com" title="Stripe">
    <img src="/images/tabs-preview.webp" alt="Stripe" />
  </Tile>
</Columns>

## Imagens no modo escuro

Use classes do Tailwind para exibir imagens diferentes nos modos claro e escuro:

```mdx
<Tile href="/customization/theming" title="Theming">
  <img src="/images/logo-light.webp" alt="Theme" class="dark:hidden" noStyle />
  <img src="/images/logo-dark.webp" alt="Theme" class="hidden dark:block" noStyle />
</Tile>
```

O atributo `noStyle` impede o estilo padrão das imagens para que as classes do modo escuro funcionem corretamente.

## Propriedades

<ParamField name="href" type="string" required>
  O URL para o qual o bloco direciona. Aceita caminhos internos (`/docs/intro`) e URLs externas (`https://example.com`). Os links externos são abertos em uma nova aba.
</ParamField>

<ParamField name="title" type="string">
  Texto do título exibido abaixo da área de prévia.
</ParamField>

<ParamField name="description" type="string">
  Texto de descrição opcional abaixo do título.
</ParamField>

<ParamField name="children" type="ReactNode">
  Conteúdo a ser exibido na área de prévia. Normalmente, imagens ou SVGs.
</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="Noções básicas de MDX" icon="file-code" href="/pt/content/mdx-basics">
    Saiba como usar componentes em MDX
  </Card>
</Columns>