<li>:列表项元素

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

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

尝试一下

属性

这个元素包含全局属性

value

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

type 已弃用 非标准

该字符属性表示编号类型:

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

该类型会覆盖其父元素 <ol> 使用的类型(如果有的话)。

备注:该属性已被弃用;请使用 CSS list-style-type 属性代替。

示例

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

有序列表

html
<ol>
  <li>第一项</li>
  <li>第二项</li>
  <li>第三项</li>
</ol>

结果

带有自定义值的有序列表

html
<ol type="I">
  <li value="3">第三项</li>
  <li>第四项</li>
  <li>第五项</li>
</ol>

结果

无序列表

html
<ul>
  <li>第一项</li>
  <li>第二项</li>
  <li>第三项</li>
</ul>

结果

技术概要

内容分类 无。
允许的内容 流式内容
标签省略 如果列表项后面紧跟着另一个 <li> 元素,或者其父元素中没有更多内容,则可以省略结束标记。
允许的父元素 一个 <ul><ol><menu> 元素。过时的 <dir> 也可以作为父级元素,但这种用法并不符合规范。
隐含的 ARIA 角色 如果是 olulmenu 的子项,则为 listitem
允许的 ARIA 角色 menuitemmenuitemcheckboxmenuitemradiooptionnonepresentationradioseparatortabtreeitem
DOM 接口 HTMLLIElement

规范

Specification
HTML Standard
# the-li-element

浏览器兼容性

BCD tables only load in the browser

参见

  • 其他与列表相关的 HTML 元素:<ul><ol><menu> 和过时的 <dir>

  • 特别适用于为 <li> 元素添加样式的 CSS 属性:

    • list-style 属性,用于选择显示序号的方式;
    • CSS 计数器,用于处理复杂的嵌套列表;
    • margin 属性,用于控制列表项的缩进。