大网数据广告活动
Web 标准与前端开发

<li>:列表项元素

· 52CE 我爱测

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

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

HTML Demo: <li>

<p>Apollo astronauts:</p>

<ul>
  <li>Neil Armstrong</li>
  <li>Alan Bean</li>
  <li>Peter Conrad</li>
  <li>Edgar Mitchell</li>
  <li>Alan Shepard</li>
</ul>
p,
li {
  font:
    1rem "Fira Sans",
    sans-serif;
}

p {
  font-weight: bold;
}

属性

这个元素包含全局属性。

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

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

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

      [!NOTE] 该属性已被弃用;请使用 CSS list-style-type 属性代替。

示例

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

有序列表

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

结果

有序列表

带有自定义值的有序列表

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

结果

带有自定义值的有序列表

无序列表

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

结果

无序列表

技术概要

<table class="properties"> <tbody> <tr> <th scope="row"> <a href="/zh-CN/docs/Web/HTML/Guides/Content_categories" >内容分类</a > </th> <td>无。</td> </tr> <tr> <th scope="row">允许的内容</th> <td> <a href="/zh-CN/docs/Web/HTML/Guides/Content_categories#流式内容" >流式内容</a >。 </td> </tr> <tr> <th scope="row">标签省略</th> <td> 如果列表项后面紧跟着另一个 li 元素,或者其父元素中没有更多内容,则可以省略结束标记。 </td> </tr> <tr> <th scope="row">允许的父元素</th> <td> 一个 ul、ol 或 menu 元素。过时的 dir 也可以作为父级元素,但这种用法并不符合规范。 </td> </tr> <tr> <th scope="row">隐含的 ARIA 角色</th> <td> 如果是 <code><a href="/zh-CN/docs/Web/HTML/Reference/Elements/ol">ol</a></code>、<code><a href="/zh-CN/docs/Web/HTML/Reference/Elements/ul">ul</a></code> 或 <code><a href="/zh-CN/docs/Web/HTML/Reference/Elements/menu">menu</a></code> 的子项,则为 <code><a href="/zh-CN/docs/Web/Accessibility/ARIA/Reference/Roles/listitem_role">listitem</a></code> </td> </tr> <tr> <th scope="row">允许的 ARIA 角色</th> <td> <a href="/zh-CN/docs/Web/Accessibility/ARIA/Reference/Roles/menuitem_role"><code>menuitem</code></a>、<a href="/zh-CN/docs/Web/Accessibility/ARIA/Reference/Roles/menuitemcheckbox_role"><code>menuitemcheckbox</code></a>、<a href="/zh-CN/docs/Web/Accessibility/ARIA/Reference/Roles/menuitemradio_role"><code>menuitemradio</code></a>、<a href="/zh-CN/docs/Web/Accessibility/ARIA/Reference/Roles/option_role"><code>option</code></a>、<a href="/zh-CN/docs/Web/Accessibility/ARIA/Reference/Roles/none_role"><code>none</code></a>、<a href="/zh-CN/docs/Web/Accessibility/ARIA/Reference/Roles/presentation_role"><code>presentation</code></a>、<a href="/zh-CN/docs/Web/Accessibility/ARIA/Reference/Roles/radio_role"><code>radio</code></a>、<a href="/zh-CN/docs/Web/Accessibility/ARIA/Reference/Roles/separator_role"><code>separator</code></a>、<a href="/zh-CN/docs/Web/Accessibility/ARIA/Reference/Roles/tab_role"><code>tab</code></a>、<a href="/zh-CN/docs/Web/Accessibility/ARIA/Reference/Roles/treeitem_role"><code>treeitem</code></a> </td> </tr> <tr> <th scope="row">DOM 接口</th> <td>HTMLLIElement</td> </tr> </tbody> </table>

规范

浏览器兼容性

参见

  • 其他与列表相关的 HTML 元素:ul、ol、menu 和过时的 dir;
  • 特别适用于为 <li> 元素添加样式的 CSS 属性:
    • list-style 属性,用于选择显示序号的方式;
    • CSS 计数器,用于处理复杂的嵌套列表;
    • margin 属性,用于控制列表项的缩进。

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。