<li>:列表项元素

基线 广泛可用

此功能已得到完善,可在许多设备和浏览器版本上运行。它自以下时间起在所有浏览器中都可用 2015 年 7 月.

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

试一试

属性

此元素包含 全局属性

value

此整数属性指示由 <ol> 元素定义的列表项的当前序数值。此属性唯一允许的值是数字,即使列表使用罗马数字或字母显示。其后的列表项将从设置的值继续编号。value 属性对无序列表 (<ul>) 或菜单 (<menu>) 没有任何意义。

type 已弃用 非标准

此字符属性指示编号类型。

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

此类型会覆盖其父级 <ol> 元素(如果存在)使用的类型。

注意:此属性已弃用;请改用 CSS list-style-type 属性。

示例

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

有序列表

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

结果

具有自定义值的有序列表

html
<ol type="I">
  <li value="3">third item</li>
  <li>fourth item</li>
  <li>fifth item</li>
</ol>

结果

无序列表

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

结果

技术摘要

内容类别 无。
允许的内容 流内容.
标签省略 如果列表项紧跟另一个 <li> 元素,或者其父元素中没有更多内容,则可以省略结束标签。
允许的父级 <ul><ol><menu> 元素。虽然不是符合标准的用法,但已废弃的 <dir> 也可以作为父级。
隐式 ARIA 角色 当作为 olulmenu 的子元素时为 listitem
允许的 ARIA 角色 menuitemmenuitemcheckboxmenuitemradiooptionnonepresentationradioseparatortabtreeitem
DOM 接口 HTMLLIElement

规范

规范
HTML 标准
# the-li-element

浏览器兼容性

BCD 表格仅在浏览器中加载

另请参阅

  • 其他与列表相关的 HTML 元素:<ul><ol><menu> 和已废弃的 <dir>
  • 可能特别有用以设置 <li> 元素样式的 CSS 属性
    • list-style 属性,用于选择序数的显示方式,
    • CSS 计数器,用于处理复杂的嵌套列表,
    • margin 属性,用于控制列表项的缩进。