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

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

属性

这个元素拥有全局属性

value
这个整数属性表明了列表的当前序号值,列表由 <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 会输出:

  1. first item
  2. second item
  3. third item
<ol type="I">
    <li value="3">third item</li>
    <li>fourth item</li>
    <li>fifth item</li>
</ol>	

上面的 HTML 会输出:

  1. third item
  2. fourth item
  3. fifth item
<ul>
    <li>first item</li>
    <li>second item</li>
    <li>third item</li>
</ul>
  • first item
  • second item
  • third item

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

规范

Specification Status Comment
HTML Living Standard
<li>
Living Standard  
HTML5
<li>
Recommendation  
HTML 4.01 Specification
<li>
Recommendation The type attribute has been deprecated.

浏览兼容性

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari
Basic support (Yes) 1.0 (1.7 or earlier) (Yes) (Yes) (Yes)
Feature Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Basic support (Yes) 1.0 (1.0) (Yes) (Yes) (Yes)

另见

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

文档标签和贡献者

 此页面的贡献者: wizardforcel, changwu, JoshuaLee
 最后编辑者: wizardforcel,