CSS ::marker
可讓您變更 HTML 清單中的內容以及項目符號和數字樣式。
![](https://web.dev/static/articles/css-marker-pseudo-element/image/WOmqXrog0YoriZqqIzEZ.png?authuser=6&hl=zh-tw)
虛擬元素簡介
虛擬元素代表文件中的一部分,在文件樹狀結構中並未顯示。舉例來說,您可以使用虛擬元素 p::first-line
選取段落的第一行,即使該行文字沒有換行的 HTML 元素也一樣。
請考慮以下 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;
}
與 list-style-type
相比,::marker
可讓您進一步控制標記樣式,但並非每個 CSS 屬性都適用。允許的屬性如下:
animation-*
transition-*
color
direction
font-*
content
unicode-bidi
white-space
使用 content
(而非 list-style-type
) 變更 ::marker
的內容。下一個範例說明如何將 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: "😍";
}
只變更一個清單項目
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 開發人員工具路徑可協助您檢查、偵錯及修改要套用至 ::marker
虛擬元素的樣式。
![開發人員工具會開啟並顯示使用者代理程式和使用者樣式的樣式](https://web.dev/static/articles/css-marker-pseudo-element/image/devtools-open-showing-st-a195bf49e23f5.png?authuser=6&hl=zh-tw)
資源
如要進一步瞭解「::marker
」,請參閱下列文章: