Extension Indentation

Choisissez le fonctionnement de l'indentation et ajustez l'indentation des lignes sélectionnées.

Où la trouver

Édition ▸ Indentation :

• Augmenter l'indentation — Ctrl+]
• Diminuer l'indentation — Ctrl+[

Les deux agissent sur chaque ligne touchée par la sélection, ou sur la ligne du curseur quand rien n'est sélectionné.

Réglages

Ouvrez Préférences ▸ Extensions ▸ Indentation :

• Style d'indentation — Tabulations, Espaces, ou Auto (détecter depuis le document).
  • Tabulations (le défaut pour les nouveaux fichiers) insère une vraie tabulation par niveau.
  • Espaces insère Espaces par indentation espaces par niveau.
  • Auto examine l'indentation existante du document et la suit — un fichier indenté par tabulations continue avec des tabulations, un fichier à 2 espaces continue avec deux espaces, etc. Un fichier encore sans indentation retombe sur le défaut (tabulations).
• Espaces par indentation — combien d'espaces composent un niveau d'indentation (également la largeur visuelle d'une tabulation).
• Lignes renvoyées — où commencent les lignes de continuation d'une longue ligne repliée (le repli lui-même s'active via Affichage ▸ Retour à la ligne) :
  • Aligner sur l'indentation de la ligne (le défaut) — les continuations s'alignent sous l'indentation de la première ligne, un bloc indenté se replie donc en une seule colonne visuelle.
  • Commencer au bord gauche — les continuations repartent du bord de la fenêtre, comme dans un traitement de texte.
  • Indenter d'un niveau supplémentaire — comme le défaut plus un niveau d'indentation en plus, ce qui rend le point de repli plus visible.
• Collage : Réindenter les lignes collées sur l'indentation du curseur (activé) — un bloc de plusieurs lignes collé à un curseur indenté est réindenté sur ce curseur au lieu d'arriver en désordre. Le comportement lui-même appartient à la commande Coller de l'éditeur ; seul l'interrupteur vit ici, à côté des autres options d'indentation. L'interrupteur s'applique aussi à Coller en Markdown. Voir Coller un bloc de code.

Le style choisi est la source unique de vérité pour tout l'éditeur : la touche Tab, la désindentation par Backspace et l'indentation automatique l'utilisent tous.

Indentation automatique

Appuyer sur Enter reporte les espaces de tête de la ligne courante sur la nouvelle ligne, pour rester à la même profondeur sans retaper tabulations ou espaces. Lorsque le curseur se trouve entre une paire d'accolades fraîchement ouverte, le bloc se déploie :

if (cond) {|}        Enter        if (cond) {
                     ───────►          |
                                   }

La nouvelle ligne est indentée d'un niveau supplémentaire et l'accolade fermante descend sur sa propre ligne à la profondeur de l'ouvrante. L'indentation automatique se retire dans les commentaires et les littéraux de chaîne, où un { est du texte ordinaire et non un ouvreur de bloc.

Le .editorconfig d'un projet et le défaut d'indentation livré pour un langage (Python → 4 espaces, Go → tabulations, …) priment tous deux sur le style global choisi ici — voir les défauts par langage pour le tableau et l'ordre de résolution complet.

Voir aussi

Pour le comportement d'édition complet — appariement automatique des parenthèses/guillemets, frappe par-dessus, suppression d'une paire vide, ouverture de bloc sur Enter, suppression dans les commentaires/chaînes et prise en charge du multi-curseur — voir Appariement automatique et indentation.