Plugin Recuo¶
Escolha como o recuo funciona e ajuste o recuo das linhas selecionadas.
Onde encontrá-lo¶
Editar ▸ Recuo:
- Aumentar o recuo —
Ctrl+] - Diminuir o recuo —
Ctrl+[
Os dois atuam sobre todas as linhas tocadas pela seleção, ou sobre a linha do cursor quando não há nada selecionado.
Configurações¶
Abra Preferências ▸ Plug-ins ▸ Recuo:
- Estilo de recuo — Tabulações, Espaços ou Automático (detectar pelo
documento).
- Tabulações (o padrão para arquivos novos) insere uma tabulação real por nível.
- Espaços insere tantos espaços por nível quanto indicar Espaços por recuo.
- Automático olha o recuo existente do documento e o segue — um arquivo recuado com tabulações continua usando tabulações, um de 2 espaços continua usando dois espaços, e assim por diante. Um arquivo que ainda não tem recuo recorre ao padrão (tabulações).
- Espaços por nível de recuo — quantos espaços formam um nível de recuo (também a largura visual de uma tabulação).
- Linhas quebradas — onde começam as linhas de continuação de uma linha longa
quebrada (a quebra em si é alternada em Exibir ▸ Quebra automática de linha):
- Alinhar com o recuo da linha (o padrão) — as linhas de continuação se alinham sob o recuo da primeira linha, de modo que um bloco recuado se quebra como uma única coluna visual.
- Começar na margem esquerda — as linhas de continuação recomeçam na borda da janela, no estilo de um processador de textos.
- Recuar um nível a mais — como o padrão, mais um nível extra de recuo, o que facilita perceber o ponto de quebra.
- Ao colar: recuar as linhas coladas conforme o recuo do cursor (ligado) — um bloco de várias linhas colado com o cursor recuado é recuado conforme aquele cursor, em vez de chegar desalinhado. O comportamento em si faz parte do comando de colar do editor; aqui fica apenas a chave, ao lado das demais opções de recuo. A chave vale também para Colar como Markdown. Veja Colando um bloco de código.
O estilo escolhido é a única fonte de verdade para o editor inteiro: a tecla Tab, o recuo reverso do Backspace e o recuo automático usam todos ele.
Recuo automático¶
Pressionar Enter leva o espaço em branco inicial da linha atual para a linha nova, de modo que você permanece na mesma profundidade sem redigitar tabulações ou espaços. Quando o cursor está entre um par de colchetes recém-aberto, o bloco se abre:
A linha nova recebe um nível a mais de recuo e a chave de fechamento desce para a
própria linha, na profundidade da abertura. O recuo automático recua dentro de
comentários e literais de string, onde um { é texto comum e não uma abertura de
bloco.
O .editorconfig de um projeto e o
padrão de recuo que uma linguagem traz (Python → 4 espaços, Go → tabulações, …)
têm ambos precedência sobre o estilo global escolhido aqui — veja
os padrões por linguagem
para a tabela e a ordem completa de resolução.
Relacionado¶
Para o comportamento completo de edição — emparelhamento automático de colchetes/aspas, digitar por cima, apagar um par vazio, abertura de bloco no Enter, supressão em comentários e strings e suporte a vários cursores — veja Pares automáticos e recuo.