CSSのlist-style-typeで箇条書きの記号や番号を変える方法

CSSのlist-style-typeは、リスト項目の先頭に表示する記号や番号の形式を指定します。順序が重要な手順には<ol>、順序を問わない項目には<ul>を使います。番号を3から始めるときは<ol start="3">と記述します。

マーカーの形式を選ぶ

discは黒丸、circleは白丸、squareは四角を表示します。番号にはdecimalとlower-romanが使えます。前者は十進数、後者は小文字のローマ数字です。noneは既定のテキストマーカーを非表示にします。

CSSの初期値はdiscですが、ブラウザーの既定のスタイルでは通常<ol>にdecimalが適用されます。実際に適用された値は項目の計算済みスタイルで確認します。

ol.steps { list-style-type: lower-roman; }
ul.topics { list-style-type: square; }

HTMLファイルを作って表示を確認する

次のコードをUTF-8のlist-style-type.htmlとして保存し、ブラウザーで開いてください。リストごとに異なるクラスを指定しているので、片方ずつ表示を変えられます。

<!doctype html>
<html lang="ja">
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <title>作業手順 / トピック</title>
  <style>
    .steps, .topics { padding-inline-start: 2em; }
    ol.steps { list-style-type: lower-roman; }
    ul.topics { list-style-type: square; }
  </style>
</head>
<body>
  <h1>作業手順</h1>
  <ol class="steps">
    <li>ファイルを保存する</li>
    <li>ファイルを開く</li>
  </ol>
  <h2>トピック</h2>
  <ul class="topics">
    <li>HTML</li>
    <li>CSS</li>
  </ul>
</body>
</html>

作業手順はi.、ii.の順に表示され、トピックには四角いマーカーが付きます。

  1. .stepsのlower-romanをdecimal、noneの順に変更します。項目の順序が保たれていることを確認し、lower-romanに戻します。
  2. <ol>にstart="3"を追加すると、iii.、iv.と表示されます。属性を削除すれば開始番号が元に戻ります。

HTML標準の順序付きリスト

継承と画像、短縮プロパティの影響

このプロパティは親のリストから項目に継承されます。ただし、入れ子のリストにブラウザーの既定値が指定される場合があります。外側とそろえたいときは、.features ul { list-style-type: inherit; }のように内側のリストを対象にします。

有効なlist-style-imageや::markerに明示したcontentがあると、表示するマーカーが変わります。list-style: insideでは、省略した種類と画像も初期値に戻ります。位置だけ変えるならlist-style-position: insideを使います。

W3Cのリストマーカー仕様

マーカーが消えたときの確認手順

  1. 開発者ツールで対象の<li>を選び、displayとlist-style-typeの計算済みの値を調べます。display: flexで項目のマーカーが消えた場合は、項目の内側にラッパーを置いてFlexboxを適用します。
  2. 画像と::markerの規則を一つずつ無効にします。設定が正しい場合は、行頭側のパディングと祖先要素のoverflowを確認します。外側のマーカーには、切り取られないだけの余白が必要です。

手順の参照に番号を使う場合は、番号を残します。Safariでは条件によって、マーカーを消したリストがアクセシビリティツリーでリストとして扱われないことがあります。対象の環境で確認し、必要に応じてrole="list"を追加してください。 MDNのリストとアクセシビリティ