<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。离线整理了版式、链接和媒体显示。
