Saltar a contenido

Plugin Sangría

Elige cómo funciona la sangría y ajusta la sangría de las líneas seleccionadas.

Dónde encontrarlo

Editar ▸ Sangría:

  • Aumentar la sangría — Ctrl+]
  • Reducir la sangría — Ctrl+[

Ambos actúan sobre todas las líneas que toca la selección, o sobre la línea del cursor cuando no hay nada seleccionado.

Ajustes

Abre Preferencias ▸ Complementos ▸ Sangría:

  • Estilo de sangría — Tabulaciones, Espacios o Automático (detectar del documento).
    • Tabulaciones (lo predeterminado para archivos nuevos) inserta una tabulación real por nivel.
    • Espacios inserta tantos espacios por nivel como indique Espacios por nivel de sangría.
    • Automático mira la sangría existente del documento y la sigue: un archivo con tabulaciones sigue usando tabulaciones, uno de 2 espacios sigue usando dos espacios, y así sucesivamente. Un archivo que aún no tiene sangría recurre al valor predeterminado (tabulaciones).
  • Espacios por nivel de sangría — cuántos espacios forman un nivel de sangría (también la anchura visual de una tabulación).
  • Líneas ajustadas — dónde empiezan las filas de continuación de una línea larga ajustada (el ajuste en sí se activa con Ver ▸ Ajuste de línea):
    • Alinear con la sangría de la línea (lo predeterminado) — las filas de continuación se alinean bajo la sangría de la primera fila, de modo que un bloque sangrado se ajusta como una única columna visual.
    • Empezar en el margen izquierdo — las filas de continuación vuelven a empezar en el borde de la ventana, al estilo de un procesador de textos.
    • Sangrar un nivel más — como lo predeterminado, más un nivel adicional de sangría, lo que hace más fácil detectar el punto de ajuste.
  • Al pegar: volver a sangrar las líneas pegadas según la sangría del cursor (activado) — un bloque de varias líneas pegado con el cursor sangrado se vuelve a sangrar según ese cursor en lugar de llegar desalineado. El comportamiento en sí forma parte del comando de pegado del editor; aquí vive solo el interruptor, junto a las demás opciones de sangría. El interruptor se aplica también a Pegar como Markdown. Consulta Pegar un bloque de código.

El estilo elegido es la única fuente de verdad para todo el editor: la tecla Tab, el Retroceso que reduce la sangría y la sangría automática lo usan todos.

Sangría automática

Pulsar Intro lleva el espacio en blanco inicial de la línea actual a la línea nueva, de modo que te quedas a la misma profundidad sin volver a escribir tabulaciones ni espacios. Cuando el cursor está entre una pareja de corchetes recién abierta, el bloque se despliega:

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

La línea nueva lleva un nivel más de sangría y la llave de cierre baja a su propia línea, a la profundidad de la apertura. La sangría automática se retira dentro de los comentarios y los literales de cadena, donde un { es texto corriente y no una apertura de bloque.

El .editorconfig de un proyecto y el valor predeterminado de sangría que trae un lenguaje (Python → 4 espacios, Go → tabulaciones, …) tienen ambos precedencia sobre el estilo global elegido aquí; consulta los valores predeterminados por lenguaje para ver la tabla y el orden de resolución completo.

Relacionado

Para el comportamiento de edición completo —emparejamiento automático de corchetes y comillas, escribir por encima, borrar una pareja vacía, apertura de bloque al pulsar Intro, supresión en comentarios y cadenas y compatibilidad con varios cursores— consulta Pares automáticos y sangría.