CSS list-style-type:如何设置列表项目符号和编号

CSS 的 list-style-type 用来设置列表项前的项目符号或编号格式。步骤顺序有意义时使用 <ol>,无需固定顺序时使用 <ul>。要从 3 开始编号,请在 <ol> 上添加 start="3"。

选择列表标记的类型

disc、circle 和 square 分别显示实心圆、空心圆和方形。数字编号可选 decimal 或 lower-roman,分别显示十进制数字和小写罗马数字。none 隐藏默认的文本标记。

该属性的 CSS 初始值是 disc。浏览器默认样式通常为 <ol> 指定 decimal。查看列表项的计算样式,即可确认实际使用的值。

ol.steps { list-style-type: lower-roman; }
ul.topics { list-style-type: square; }

在浏览器中运行完整示例

将以下完整代码以 UTF-8 编码保存为 list-style-type.html,然后在浏览器中打开。两种列表使用不同的类,可单独修改和对比。

<!doctype html>
<html lang="zh-CN">
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <title>操作步骤 / 主题</title>
  <style>
    .steps, .topics { padding-inline-start: 2em; }
    ol.steps { list-style-type: lower-roman; }
    ul.topics { list-style-type: square; }
  </style>
</head>
<body>
  <h1>操作步骤</h1>
  <ol class="steps">
    <li>保存文件</li>
    <li>打开文件</li>
  </ol>
  <h2>主题</h2>
  <ul class="topics">
    <li>HTML</li>
    <li>CSS</li>
  </ul>
</body>
</html>

步骤列表显示 i. 和 ii.,主题列表使用方形项目符号。

  1. 在 .steps 的规则中,把 lower-roman 依次改为 decimal 和 none。确认列表项的顺序保持不变,然后恢复 lower-roman。
  2. 给 <ol> 添加 start="3" 后,编号会显示为 iii. 和 iv.。删除该属性,编号就会重新从 1 开始。

HTML 标准中的有序列表

继承、图片标记与简写属性

列表项通常会继承父列表的值。不过,浏览器也可能为嵌套列表单独指定默认值。要让内层列表沿用外层样式,可以用 .features ul { list-style-type: inherit; } 等规则选中内层列表。

有效的 list-style-image 或为 ::marker 显式指定的 content 都可能改变实际显示的标记。list-style: inside 会把省略的类型和图片属性重置为初始值。如果只想移动标记,请使用 list-style-position: inside。

W3C 的 CSS 列表标记规范

标记消失时如何排查

  1. 在开发者工具中选择对应的 <li>,检查 display 与 list-style-type 的计算值。若 display: flex 导致列表项失去生成标记的盒子,可以在列表项内部添加容器,再将其设为弹性布局。
  2. 逐条禁用图片标记和 ::marker 规则。如果计算值正确,请检查行内起始侧的内边距以及祖先元素的 overflow。外侧标记可能因为空间不足而被裁切。

如果读者需要通过编号定位步骤,请保留编号。在某些情形下,Safari 不会在无障碍树中将隐藏了标记的列表呈现为列表。请在目标环境中检查,必要时为列表添加 role="list"。 MDN 的列表无障碍说明