Pular para conteúdo

Dobra de código

Recolha e expanda regiões estruturadas de um arquivo — funções, blocos, classes e outras construções da linguagem — para se concentrar em uma parte e ocultar o resto.

Como usar

  • Os marcadores de dobra ([+] / [−]) aparecem em uma margem ao lado das linhas dobráveis. Clique em um deles para recolher ou expandir aquela região.
  • Uma região recolhida aparece como uma única linha de cabeçalho com um separador desenhado abaixo; expandi-la restaura as linhas ocultas.
  • Saltar para uma linha oculta (ir para a linha, um resultado de busca, um marcador) a revela automaticamente.
  • A dobra segue o limite de tamanho da coloração de sintaxe (Preferências ▸ Sintaxe ▸ tamanho máximo de arquivo, 16 MB por padrão): um arquivo acima dele abre como texto simples e não tem margem de dobra, porque os níveis de dobra são produzidos pela mesma passagem do analisador léxico. Os recursos do servidor de linguagem não são afetados por esse limite.

Comandos

Menu Exibir:

Comando Atalho
Alternar dobramento (a região onde está o cursor) Ctrl+Alt+F (⌥⌘← no macOS)
Dobrar tudo Ctrl+Alt+Shift+F
Desdobrar tudo Ctrl+Alt+Shift+U

Precisa de uma linguagem

A dobra segue a estrutura da linguagem do documento, então a margem de dobra aparece assim que um colorizador de sintaxe está ativo para o arquivo. Texto simples, não reconhecido, não tem regiões de dobra.

Em um arquivo muito grande as dobras aparecem aos poucos

A coloração — e com ela a estrutura de dobra — é calculada primeiro para o que está na tela e, em segundo plano, para o resto do arquivo. Por isso, em um arquivo de vários megabytes, os marcadores de dobra bem abaixo da área visível aparecem um instante depois, quando essa passagem em segundo plano chega até eles. Dobrar tudo espera pelo arquivo inteiro, então sempre dobra tudo.