<li>

HTML <li> 元素 （或称 HTML 列表条目元素） 用于表示列表里的条目。它必须包含在一个父元素里：一个有序列表 (<ol>)，一个无序列表 (<ul>)，或者一个菜单 (<menu>)。在菜单或者无序列表里，列表条目通常用点排列显示；在有序列表里，列表条目通常在左边显示按升序排列的计数，例如数字或者字母。

内容类别 无
允许的内容 流式内容
标签省略 如果列表元素的后面紧随另一个 <li> 元素，或者它的父元素中没有更多内容，结束标签可以省略。
允许的父元素 <ul>、 <ol>、或者 <menu> 元素。过时的 <dir> 也可以作为父元素，但是并不提倡。
DOM 接口 HTMLLIElement
元素类型 块级

属性

这个元素拥有全局属性。

value

这个整数型属性表明了本 <li> 元素在有序列表（由 <ol> 元素定义）中的序号。本属性值只能用数字，即使列表使用罗马数字或字母来展示。随后的列表条目会从设置的值开始计数。value 属性对于无序列表 (<ul>) 或者菜单 (<menu>) 无效。

备注： 这个属性在 HTML 4 中废弃，但是在 HTML 5 中重新引入。

备注： 在 Gecko 9.0 之前，负值会错误地转换为 0。Gecko 9.0 开始，所有整数值都可以正确解析。

type

这个字符型属性表明了数字的类型：

  • a: 小写字母
  • A: 大写字母
  • i: 小写罗马数字
  • I: 大写罗马数字
  • 1: 数字本属性值将覆盖 <ol> 元素中的同名属性值（若存在）。

备注： 本属性已废弃：使用 CSS list-style-type 属性来代替。

示例

有序列表

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

上面的 HTML 会输出：

无序列表

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

更多具体示例请见 <ol> 和 <ul> 页面。

规范

Specification
HTML Standard
# the-li-element

浏览兼容性

BCD tables only load in the browser

另见

  • 其他列表相关的 HTML 元素： <ul>, <li>, <menu>, 和过时的 <dir>；
  • 可能特定用于排版 <li> 元素的 CSS 属性：
    • list-style 属性，用于选择序号的展示方式，
    • CSS 计数器，用于处理复杂的嵌套列表，
    • margin 属性，用于控制列表条目的缩进。