使用 CSS 的自訂項目符號 ::marker

Adam Argyle
Oriol Brufau
Oriol Brufau
GitHub

瀏覽器支援

  • 86
  • 86
  • 68
  • 11.1

來源

CSS ::marker 可讓您變更 HTML 清單中的內容以及項目符號和數字樣式。

項目符號樣式範例。查看原始碼

虛擬元素簡介

虛擬元素代表文件中的一部分，在文件樹狀結構中並未顯示。舉例來說，您可以使用虛擬元素 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 虛擬元素的樣式。

開發人員工具會開啟並顯示使用者代理程式和使用者樣式的樣式
標記樣式的開發人員工具說明。

資源

如要進一步瞭解「::marker」，請參閱下列文章：