CSS ::marker を使用したカスタムの箇条書き

Adam Argyle
Oriol Brufau
Oriol Brufau
GitHub

2020 年 9 月 2 日公開

Browser Support

  • Chrome: 86.
  • Edge: 86.
  • Firefox: 68.
  • Safari: 11.1.

Source

CSS ::marker を使用すると、HTML リストの箇条書きと番号のコンテンツとスタイルの一部を変更できます。

箇条書きのスタイルの例。

疑似要素の概要

疑似要素は、ドキュメント ツリーに表されていないドキュメント内の部分を表します。たとえば、テキスト行をラップする HTML 要素がない場合でも、疑似要素 p::first-line を使用して段落の最初の行を選択できます。

次の HTML 順序なしリストについて考えてみましょう。

<ul>
  <li>Lorem ipsum dolor sit amet consectetur adipisicing elit</li>
  <li>Dolores quaerat illo totam porro</li>
  <li>Quidem aliquid perferendis voluptates</li>
  <li>Ipsa adipisci fugit assumenda dicta voluptates nihil reprehenderit
      consequatur alias facilis rem</li>
  <li>Fuga</li>
</ul>

デフォルトのスタイル設定では、次のように表示されます。

各 <ul> 要素の先頭にあるドットは、リストのレンダリング の一部として生成され、独自の HTML 要素はありません。::marker は、そのドットまたは順序付きリスト要素の先頭にある番号を表す疑似要素です。

マーカーを作成する

::marker 疑似要素マーカー ボックスは、実際のコンテンツと ::before 疑似要素の両方の前に、すべてのリストアイテム要素内に自動的に生成されます。

li::before {
  content: "::before";
  background: lightgray;
  border-radius: 1ch;
  padding-inline: 1ch;
  margin-inline-end: 1ch;
}

リストアイテムは通常 <li> HTML 要素ですが、display: list-item を使用して他の要素をリストアイテムにすることもできます。

<dl>
  <dt>Lorem</dt>
  <dd>Lorem ipsum dolor sit amet consectetur adipisicing elit</dd>
  <dd>Dolores quaerat illo totam porro</dd>

  <dt>Ipsum</dt>
  <dd>Quidem aliquid perferendis voluptates</dd>
</dl>

dd {
  display: list-item;
  list-style-type: "🤯";
  padding-inline-start: 1ch;
}

マーカーのスタイルを設定する

::marker が利用可能になる前は、list-style-type と list-style-image を使用してリストのスタイルを設定し、リストアイテムの記号を変更していました。

li {
  list-style-image: url(/right-arrow.svg);
  /* OR */
  list-style-type: '👉';
  padding-inline-start: 1ch;
}

::marker を使用すると、CSS でマーカーの疑似要素を個別に、またはグローバルにターゲットにすることで、マーカーの色、サイズ、間隔を変更できます。

li::marker {
  color: hotpink;
}

li:first-child::marker {
  font-size: 5rem;
}
この例では、ピンクの箇条書きが表示されます。ブラウザにデフォルトが表示される場合は、::marker がサポートされていません。

::marker を使用すると、list-style-type よりもマーカーのスタイルを細かく制御できますが、すべての CSS プロパティで動作するわけではありません。使用できるプロパティは次のとおりです。

  • animation-*
  • transition-*
  • color
  • direction
  • font-*
  • content
  • unicode-bidi
  • white-space

::marker のコンテンツを変更するには、list-style-type ではなく content を使用します。次の例は、list-style-type のプロパティがリストアイテム全体に適用されるのに対し、::marker ではマーカー ボックスのみをターゲットにできることを示しています。background プロパティは list-style-type では機能しますが、::marker では機能しません。

リストのスタイル
li:nth-child(1) {
  list-style-type: '?';
  font-size: 2rem;
  background: hsl(200 20% 88%);
  animation: color-change 3s ease-in-out infinite;
}
 リストのスタイル設定は、リストアイテム全体に影響します。
マーカー スタイル
li:nth-child(2)::marker {
  content: '!';
  font-size: 2rem;
  background: hsl(200 20% 88%);
  animation: color-change 3s ease-in-out infinite;
}
 マーカーのスタイル設定では、マーカーに焦点を当てることができます。

マーカーのコンテンツを変更する

マーカーのスタイルを設定する方法の例をいくつか示します。

すべてのリストアイテムを変更する

li {
  list-style-type: "😍";
}

/* OR */

li::marker {
  content: "😍";
}

SVG でマーカーを定義する

li::marker {
  content: url(/heart.svg);
  content: url(#heart);
  content: url("data:image/svg+xml;charset=UTF-8,<svg xmlns='http://www.w3.org/2000/svg' version='1.1' height='24' width='24'><path d='M12 21.35l-1.45-1.32C5.4 15.36 2 12.28 2 8.5 2 5.42 4.42 3 7.5 3c1.74 0 3.41.81 4.5 2.09C13.09 3.81 14.76 3 16.5 3 19.58 3 22 5.42 22 8.5c0 3.78-3.4 6.86-8.55 11.54L12 21.35z' fill='none' stroke='hotpink' stroke-width='3'/></svg>");
}

順序付きリストを変更する

<ol> はどうでしょうか。順序付きリストアイテムのマーカーは、デフォルトではドットや「箇条書き」ではなく数字です。 CSS では、これらは カウンターと呼ばれ、 番号の開始位置と終了位置を設定またはリセットしたり、 ローマ数字に切り替えたりするプロパティがあります。::marker を使用してカウンターのスタイルを設定することも、マーカーのコンテンツ値を使用して独自の番号付け表示を作成することもできます。

li::marker {
  content: counter(list-item) " AND a ";
  color: hotpink;
}

デバッグ

Chrome DevTools を使用すると、::marker 疑似要素に適用するスタイルの検査、デバッグ、変更を行うことができます。

DevTools が開いており、ユーザー エージェントのスタイルとユーザーのスタイルが表示されている
マーカー スタイルの DevTools の説明。

リソース

::marker の詳細については、以下をご覧ください。