CSSのtab-sizeでタブの表示間隔を設定する方法

CSSの tab-size は、保持されたタブ文字(U+0009)を表示するとき、タブ位置の間隔を決めます。コードブロックで空白4文字分の間隔を使うには tab-size: 4 を指定し、white-space: pre などでタブを保持します。通常の空白やファイルに保存したインデントの文字はそのままです。

数値と長さのどちらを使うか

値 タブ位置の間隔
8 フォントの空白幅の8倍。初期値です。
4 フォントの空白幅の4倍。
24px 長さの指定に対応するブラウザーでは24px間隔。

タブ位置はコンテンツの始端から一定間隔で並びます。タブは次の文字をタブ位置に移すので、移動量はその前の文字列の長さによって変わります。値は子孫要素に継承されます。

W3C CSS Text仕様におけるtab-sizeの定義

4文字幅と8文字幅のタブ位置を比較する

以下のコード全体をUTF-8で tab-size-example.html として保存し、ブラウザーで開きます。等幅フォントで表示した各行の | の位置を比べます。

<!doctype html>
<html lang="ja">
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <title>4文字幅と8文字幅のタブ位置を比較する</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>通常の空白4つ</p>
  <pre class="spaces four">A    |
ABC    |</pre>
</body>
</html>

最初のボックスでは二つの印が始端から空白4つ分、二つ目では空白8つ分の位置にそろいます。三つ目は空白の手前の文字数が異なるため、印が別々の位置になります。

タブでは縦棒が4文字幅または8文字幅の位置にそろい、通常の空白4つでは二つの縦棒の位置がずれる比較

HTMLに実際のタブ文字を入れる

例の &#9; はHTMLの文字参照で、ブラウザーでは実際のタブ一文字になります。Tabキーで空白を入れる設定のエディターでも使えます。JavaScriptの文字列内でタブを表すには \t を使います。

三つ目のボックスのクラスを spaces eight に変更しても、通常の空白の幅は変わりません。最初のボックスを eight にすると印が8文字幅の位置に移ります。確認後は元のクラスに戻します。

タブを残して長い行を処理する

white-space: normal ではタブが折り畳まれる空白として扱われ、tab-size による違いが見えません。行をそのまま保持するには pre、空白とタブを保持しながら長い行を折り返すには pre-wrap を使います。

長いコードを一行で表示する場合は、コードブロックに overflow-x: auto を指定します。ブロック内を横にスクロールでき、コピーするソースはそのままです。

W3C CSS Text仕様の空白と折り返しの規則

間隔が変わらないとき

対象要素の tab-size と white-space の計算値を確認します。エディターで空白文字の表示を有効にすると、タブと通常の空白を区別できます。

プロポーショナルフォントでは文字の幅が異なるので、タブの後の文字が想定した列にそろわない場合があります。コードには等幅フォントを、行と列を持つデータにはHTMLの表を使います。