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>
元素所使用的类型,如果存在的话。使用注解: 这个属性已经废弃了:使用 CSSlist-style-type
属性来代替。
示例
<ol> <li>first item</li> <li>second item</li> <li>third item</li> </ol>
上面的 HTML 会输出:
- first item
- second item
- third item
<ol type="I"> <li value="3">third item</li> <li>fourth item</li> <li>fifth item</li> </ol>
上面的 HTML 会输出:
- third item
- fourth item
- fifth item
<ul> <li>first item</li> <li>second item</li> <li>third item</li> </ul>
- first item
- second item
- third item
规范
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
属性,用于控制列表条目的缩进。