> ## Documentation Index
> Fetch the complete documentation index at: https://craft-support.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Seções recolhíveis

> Aprenda a usar toggles para recolher e expandir Blocos de conteúdo, mantendo seus Documentos limpos e organizados.

Toggles são uma maneira poderosa de ocultar e revelar conteúdo nos seus Documentos. Eles ajudam você a manter seu ambiente de trabalho limpo e focado, permitindo recolher seções nas quais você não está trabalhando ativamente.

<iframe src="https://www.youtube-nocookie.com/embed/t7bow8G1sNE" title="Craft Toggles Tutorial" className="w-full aspect-video rounded-xl" allowFullScreen />

## O que são Toggles?

Um toggle é um Bloco recolhível que pode ocultar ou mostrar seu conteúdo aninhado. Pense nele como um acordeão ou uma seção dropdown – você pode clicar para expandir e ver o que há dentro, ou recolher para economizar espaço.

Toggles são perfeitos para:

* Ocultar informações detalhadas que nem sempre são necessárias
* Criar documentos no estilo FAQ
* Manter material de referência acessível, mas fora do caminho
* Gerenciar Documentos longos com muitas seções
* Criar apresentações e documentos compartilhados mais limpos

## Como criar um Toggle

Existem várias maneiras de criar um toggle no Craft:

### Usando o slash menu

<Steps>
  <Step>
    Digite `/` para abrir o slash menu
  </Step>

  <Step>
    Procure por "toggle" ou role até encontrá-lo
  </Step>

  <Step>
    Selecione "Toggle" no menu
  </Step>

  <Step>
    Digite o título do seu toggle (a parte que fica sempre visível)
  </Step>

  <Step>
    Pressione Enter para criar conteúdo dentro do toggle
  </Step>
</Steps>

### Usando o atalho Markdown

Se preferir manter as mãos no teclado, você pode transformar um Bloco em toggle enquanto digita:

<Steps>
  <Step>
    Posicione o cursor no início de um Bloco vazio
  </Step>

  <Step>
    Digite um sinal de mais (`+`) seguido de um espaço
  </Step>
</Steps>

O Bloco se transforma instantaneamente em um toggle e os caracteres `+ ` são removidos. Digite o título do toggle e pressione Enter para adicionar conteúdo dentro dele.

<Tip>
  Este é o mesmo estilo de atalho que o Craft usa para outros Blocos, como `-` e espaço para uma lista com marcadores ou `1.` e espaço para uma lista numerada.
</Tip>

### Convertendo conteúdo existente

Você pode transformar qualquer Bloco que contenha conteúdo aninhado em um toggle:

<Steps>
  <Step>
    Clique no Bloco que contém conteúdo aninhado
  </Step>

  <Step>
    Clique com o botão direito (ou use o menu do Bloco)
  </Step>

  <Step>
    Selecione "Converter em Toggle"
  </Step>
</Steps>

O Bloco vira um toggle com todo o seu conteúdo aninhado oculto por padrão.

## Expandir e recolher toggles

**Para expandir um toggle**: clique no ícone de seta (▶) ao lado do título do toggle. A seta gira para baixo (▼) e o conteúdo aparece.

**Para recolher um toggle**: clique novamente no ícone de seta para ocultar o conteúdo.

<Info title="Atalhos de teclado">
  * Transformar o Bloco atual em toggle: `Cmd+Option+7` (macOS) ou `Ctrl+Shift+7` (Windows)
  * Expandir ou recolher todos os toggles do documento de uma vez: `Cmd+Option+T` (macOS) ou `Ctrl+Alt+T` (Windows)
</Info>

## Trabalhando com toggles aninhados

Toggles podem conter outros toggles, criando múltiplos níveis de conteúdo recolhível. Isso é útil para criar estruturas de informação hierárquicas:

```
▶ Project Overview
  ▶ Phase 1: Planning
    - Requirements gathering
    - Stakeholder meetings
  ▶ Phase 2: Development
    - Sprint 1
    - Sprint 2
```

Cada nível de toggle pode ser expandido ou recolhido de forma independente.

## Dicas e boas práticas

* **Use títulos descritivos.** O título é a única parte sempre visível, então deixe claro o que há dentro.
* **Não abuse.** Muitos toggles podem transformar um Documento em um labirinto. Use-os para conteúdo realmente opcional.
* **Pense no que está visível ao compartilhar.** Informações importantes devem ser legíveis sem cliques extras.
* **Combine com outros recursos.** Toggles funcionam bem com cards, listas e cabeçalhos para estruturar um Documento.

## Convertendo de volta para Blocos normais

Se decidir que não quer mais um toggle:

<Steps>
  <Step>
    Expanda o toggle para ver o conteúdo
  </Step>

  <Step>
    Clique com o botão direito no Bloco toggle
  </Step>

  <Step>
    Selecione "Converter em Bloco normal" (ou use Desagrupar)
  </Step>
</Steps>

O conteúdo permanecerá, mas ficará sempre visível.

## Quando usar Toggles

Use um toggle quando quiser que o conteúdo fique oculto, mas rapidamente acessível na mesma visualização, como material opcional ou de referência, respostas de FAQ ou detalhes de suporte. Alguns padrões comuns:

* **Notas de reunião**: itens da agenda ficam visíveis, anotações de discussão ficam em toggles
* **Documentação do projeto**: a visão geral fica sempre visível, detalhes técnicos ficam em toggles
* **Materiais de estudo**: as perguntas ficam visíveis, as respostas ficam ocultas até serem necessárias

Use uma Página quando o conteúdo merecer seu próprio espaço dedicado para navegar, for substancial e autocontido, ou pertencer a uma estrutura hierárquica mais profunda.

<CardGroup cols={2}>
  <Card title="Blocos e Páginas" href="/pt-BR/write-and-edit/blocks-and-pages">
    Entendendo a estrutura do Craft
  </Card>

  <Card title="Estilo do Documento" href="/pt-BR/write-and-edit/styling">
    Formate e estilize seu conteúdo
  </Card>

  <Card title="Coleções" href="/pt-BR/organize-and-find/collections">
    Recursos tipo banco de dados para dados estruturados
  </Card>
</CardGroup>