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 d'après 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).

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.