Como ajustar as tabulações no CSS com tab-size

No CSS, tab-size define a distância entre as paradas ao exibir uma tabulação preservada (U+0009). Para um intervalo de quatro espaços em um bloco de código, use tab-size: 4 e preserve as tabulações com um valor como white-space: pre. Os espaços comuns e os caracteres de recuo salvos continuam iguais.

Escolha um número ou um comprimento

Valor Distância entre as paradas
8 Oito vezes a largura do espaço na fonte. É o valor inicial.
4 Quatro vezes a largura do espaço na fonte.
24px Um intervalo de 24px em navegadores que aceitam comprimentos.

As paradas se repetem a intervalos regulares a partir do início do conteúdo. Cada tabulação leva o caractere seguinte a uma parada. A distância depende do que já está na linha. A propriedade é herdada.

Definição de tab-size na especificação CSS Text do W3C

Compare paradas de quatro e oito espaços

Salve o código completo como tab-size-example.html em UTF-8 e abra-o no navegador. Compare a posição de | em cada linha da fonte monoespaçada.

<!doctype html>
<html lang="pt">
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <title>Compare paradas de quatro e oito espaços</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>Quatro espaços comuns</p>
  <pre class="spaces four">A    |
ABC    |</pre>
</body>
</html>

Na primeira caixa, os dois marcadores ficam a quatro larguras de espaço do início. Na segunda, ficam a oito. Na terceira, eles aparecem em colunas diferentes porque as linhas começam com quantidades diferentes de letras.

As barras se alinham na parada de quatro espaços e na de oito. Com quatro espaços comuns, elas ficam em colunas diferentes.

Insira tabulações reais em HTML

O exemplo usa &#9;, uma referência de caractere HTML que se torna uma tabulação real. Ela funciona mesmo se o editor inserir espaços ao pressionar Tab. Em uma string JavaScript, use \t.

Mude a classe da terceira caixa para spaces eight. Os espaços comuns continuam com a mesma largura. Se mudar a classe da primeira para eight, os marcadores vão para a parada de oito espaços. Restaure as classes após comparar.

Preserve tabulações e trate linhas longas

Com white-space: normal, as tabulações são tratadas como espaço em branco colapsável, então a diferença de tab-size desaparece. Use pre para manter as linhas ou pre-wrap para preservar espaços e tabulações e permitir que linhas longas quebrem.

Para manter uma linha longa de código em uma única linha, use overflow-x: auto no bloco. Assim é possível rolar dentro dele e copiar o código original.

Regras do CSS Text do W3C sobre espaços em branco e quebras

Quando o espaçamento não muda

Confira os valores computados de tab-size e white-space. Ative as marcas de espaços em branco no editor para distinguir tabulações e espaços no código-fonte.

Em fontes proporcionais, as letras têm larguras diferentes, então uma tabulação pode levar a uma coluna inesperada. Use fonte monoespaçada para código e tabela HTML para dados em linhas e colunas.