<li>: 列表项元素

Baseline 已广泛支持

此特性已相当成熟,可在许多设备和浏览器版本上使用。自 ⁨2015 年 7 月⁩以来,各浏览器均已提供此特性。

<li> HTML 元素用于表示列表中的一项。它必须包含在父元素中:有序列表 (<ol>)、无序列表 (<ul>) 或菜单 (<menu>)。在菜单和无序列表中,列表项通常使用项目符号显示。在有序列表中,它们通常在左侧显示一个递增的计数器,例如数字或字母。

试一试

<p>Apollo astronauts:</p>

<ul>
  <li>Neil Armstrong</li>
  <li>Alan Bean</li>
  <li>Peter Conrad</li>
  <li>Edgar Mitchell</li>
  <li>Alan Shepard</li>
</ul>
p,
li {
  font:
    1rem "Fira Sans",
    sans-serif;
}

p {
  font-weight: bold;
}

属性

此元素包含全局属性

value

此整数属性表示由 <ol> 元素定义的列表项的当前序号值。此属性唯一允许的值是一个数字,即使列表以罗马数字或字母显示也是如此。此列表项之后的列表项将从设置的值开始继续编号。此属性对无序列表 (<ul>) 或菜单 (<menu>) 没有意义。

type 已弃用

此字符属性指示编号类型

  • a:小写字母
  • A:大写字母
  • i:小写罗马数字
  • I:大写罗马数字
  • 1:数字

如果存在,此类型将覆盖其父 <ol> 元素使用的类型。

注意:此属性已弃用;请使用 CSS list-style-type 属性代替。

示例

有关更详细的示例,请参阅 <ol><ul> 页面。

有序列表

html
<ol>
  <li>first item</li>
  <li>second item</li>
  <li>third item</li>
</ol>

结果

带有自定义值的有序列表

html
<ol type="I">
  <li value="3">third item</li>
  <li>fourth item</li>
  <li>fifth item</li>
</ol>

结果

无序列表

html
<ul>
  <li>first item</li>
  <li>second item</li>
  <li>third item</li>
</ul>

结果

技术摘要

内容类别 无。
允许内容 流内容.
标签省略 如果列表项后面立即是另一个 <li> 元素,或者其父元素中没有更多内容,则可以省略结束标签。
允许父级 一个 <ul><ol><menu> 元素。尽管不是符合规范的用法,但已废弃的 <dir> 也可以作为父元素。
隐式 ARIA 角色 当是 <ol><ul><menu> 的子元素时为 listitem
允许的 ARIA 角色 menuitemmenuitemcheckboxmenuitemradiooptionnonepresentationradioseparatortabtreeitem
DOM 接口 HTMLLIElement

规范

规范
HTML
# the-li-element

浏览器兼容性

另见

  • 其他与列表相关的 HTML 元素:<ul><ol><menu> 以及已废弃的 <dir>
  • 对样式设置 <li> 元素特别有用的 CSS 属性
    • list-style 属性,用于选择序号的显示方式,
    • CSS 计数器,用于处理复杂的嵌套列表,
    • margin 属性,用于控制列表项的缩进。