<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 角色 如果是 ol、ul 或 menu 的子项，则为 listitem
允许的 ARIA 角色 menuitem、menuitemcheckbox、menuitemradio、option、none、presentation、radio、separator、tab、treeitem
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 属性，用于控制列表项的缩进。