CSS の ::marker
を使用すると、HTML リストの箇条書きと番号のコンテンツと一部のスタイルを変更できます。
![](https://web.dev/static/articles/css-marker-pseudo-element/image/WOmqXrog0YoriZqqIzEZ.png?authuser=5&hl=ja)
擬似要素の概要
疑似要素は、ドキュメント ツリーに表示されていないドキュメント内の部分を表します。たとえば、擬似要素 p::first-line
を使用すると、そのテキスト行をラップする HTML 要素がなくても、段落の 1 行目を選択できます。
次の 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
は 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: "😍";
}
1 つのリストアイテムのみを変更します
li:last-child::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) "› ";
color: hotpink;
}
デバッグ
Chrome DevTools を使用すると、::marker
疑似要素に適用するスタイルの検査、デバッグ、変更を行うことができます。
![DevTools が開き、ユーザー エージェントとユーザー スタイルのスタイルが表示されている](https://web.dev/static/articles/css-marker-pseudo-element/image/devtools-open-showing-st-a195bf49e23f5.png?authuser=5&hl=ja)
リソース
::marker
の詳細については、以下を参照してください。