Cómo ajustar los tabuladores en CSS con tab-size

En CSS, tab-size establece la distancia entre paradas al mostrar un tabulador conservado (U+0009). Para separar las paradas por el ancho de cuatro espacios en un bloque de código, usa tab-size: 4 y conserva los tabuladores con un valor como white-space: pre. Los espacios normales y la sangría guardada no cambian.

Elige un número o una longitud

Valor Distancia entre paradas
8 Ocho veces el ancho del espacio de la fuente. Es el valor inicial.
4 Cuatro veces el ancho del espacio de la fuente.
24px Un intervalo de 24px en los navegadores que admiten valores de longitud.

Las paradas se repiten desde el borde inicial del contenido. Un tabulador desplaza el siguiente carácter hasta una parada, por lo que la distancia depende de lo que ya hay en la línea. La propiedad se hereda.

Definición de tab-size en CSS Text del W3C

Compara paradas de cuatro y ocho espacios

Guarda el ejemplo completo en UTF-8 como tab-size-example.html y ábrelo en el navegador. Compara la posición de | en cada línea monoespaciada.

<!doctype html>
<html lang="es">
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <title>Compara paradas de cuatro y ocho espacios</title>
  <style>
    pre {
      font: 16px/1.5 monospace;
      padding: .5rem;
      background: #edf5ff;
      white-space: pre;
      overflow-x: auto;
    }
    .four { tab-size: 4; }
    .eight { tab-size: 8; }
  </style>
</head>
<body>
  <p>tab-size: 4</p>
  <pre class="four">A&#9;|
ABC&#9;|</pre>
  <p>tab-size: 8</p>
  <pre class="eight">A&#9;|
ABC&#9;|</pre>
  <p>Cuatro espacios normales</p>
  <pre class="spaces four">A    |
ABC    |</pre>
</body>
</html>

Los dos marcadores de la primera caja quedan a cuatro anchos de espacio del comienzo. Los de la segunda quedan a ocho. En la tercera ocupan columnas distintas porque las líneas empiezan con un número diferente de letras.

Las barras coinciden en la parada de cuatro espacios o en la de ocho, pero quedan en columnas distintas al escribir cuatro espacios normales

Inserta tabuladores reales en HTML

El ejemplo usa &#9;, una referencia de carácter HTML que se convierte en un tabulador real. Funciona aunque el editor introduzca espacios al pulsar Tab. En una cadena de JavaScript puedes usar \t.

Cambia la clase de la tercera caja a spaces eight. Sus espacios conservan el mismo ancho. Si cambias la clase de la primera a eight, los marcadores se desplazan a la parada de ocho espacios. Restaura las clases después de comparar.

Conserva tabuladores y gestiona líneas largas

Con white-space: normal, los tabuladores se tratan como espacios en blanco colapsables y el efecto de tab-size desaparece. Usa pre para conservar las líneas o pre-wrap para conservar espacios y tabuladores y permitir el ajuste de las líneas largas.

Para mantener una línea larga de código sin saltos, aplica overflow-x: auto al bloque. Así se puede desplazar en horizontal y copiar el código original.

Reglas de CSS Text del W3C sobre espacios en blanco y saltos de línea

Si el espacio no cambia

Consulta los valores calculados de tab-size y white-space en el elemento. Activa la visualización de espacios en blanco en el editor para distinguir tabuladores de espacios en el código fuente.

Las fuentes proporcionales tienen letras de distintos anchos, así que el texto tras un tabulador puede caer en otra columna. Usa una fuente monoespaciada para código y una tabla HTML para datos organizados en filas y columnas.