<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
# the-li-element

浏览器兼容性

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
li
type
Deprecated
value

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
Deprecated. Not for use in new websites.

参见

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

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

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