使用 CSS ::marker 的自定义项目符号

现在，使用 <ul> 或 <ol> 时，自定义数字或项目符号的颜色、大小或类型非常简单。

Adam Argyle
Oriol Brufau
Oriol Brufau
GitHub

得益于由 Bloomberg 赞助的 Igalia，我们终于摆脱了样式设置方面的小窍门。看！

查看源代码

借助 CSS ::marker，我们可以更改项目符号和编号的内容以及部分样式。

浏览器兼容性

::marker 适用于桌面版和 Android 版 Firefox、桌面版 Safari 和 iOS Safari（但只有 color 和 font-* 属性，请参阅 bug 204163）以及基于 Chromium 的桌面浏览器和 Android 浏览器。

浏览器支持

  • 86
  • 86
  • 68
  • 11.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>

这将导致以下呈现效果出乎意料：

每 <li> 项内容开头的圆点是免费的！浏览器正在为您绘制并创建生成的标记框。

今天，我们很高兴地介绍一下 ::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 设置列表样式，以通过 1 行 CSS 更改列表项符号：

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 伪元素表示您可以定位标记本身并直接对其应用样式。这可以实现更多控制。

也就是说，您无法在 ::marker 上使用所有 CSS 属性。规范中明确指出了允许/禁止哪些属性的列表。如果您尝试使用此伪元素添加一些有趣的内容，但不起作用，则通过以下列表了解使用 CSS 可以执行和不可以执行的操作：

允许的 CSS ::marker 属性

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

通过 content（而不是 list-style-type）更改 ::marker 的内容。在下面的示例中，第一个列表项使用 list-style-type 设置样式，第二个列表项使用 ::marker 设置样式。第一种情况中的属性适用于整个列表项，而不只是标记，这意味着文本与标记一样具有动画效果。使用 ::marker 时，我们可以仅定位到标记框，而不定位到文本。

另请注意，不允许使用的 background 属性是没有任何作用的。

列出样式
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 中，这些称为计数器，功能非常强大。它们甚至提供用于设置和重置数字开始和结束位置的属性，或者将其转换为罗马数字。我们可以设置样式吗？没错，我们甚至可以使用标记内容值构建自己的编号演示文稿。

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

调试

利用 Chrome 开发者工具，您可以检查、调试和修改应用于 ::marker 伪元素的样式。

已打开开发者工具，并显示来自用户代理和用户样式的样式

未来的伪元素样式

您可以访问以下网址，详细了解::marker：

能够接触到很难进行样式创作的感觉真的很棒。您可能希望设置其他自动生成的元素的样式。您可能会对 <details> 或搜索输入自动补全指示器不满，因为这些元素在各浏览器中的实现方式并不相同。若要分享您所需的信息，一种方法是在 https://webwewant.fyi 上创建需求。