--- title:
HTML <ol>
元素表示有序列表,通常渲染为一个带编号的列表。
{{EmbedInteractiveExample("pages/tabbed/ol.html", "tabbed-shorter")}}
The source for this interactive example is stored in a GitHub repository. If you'd like to contribute to the interactive examples project, please clone https://github.com/mdn/interactive-examples and send us a pull request.
内容类别 | Flow content, and if the <ol> element's children include at least one {{HTMLElement("li")}} element, palpable content. |
---|---|
允许的内容 | Zero or more {{ HTMLElement("li") }}, {{HTMLElement("script")}} and {{HTMLElement("template")}} elements. |
标签省略 | {{no_tag_omission}} |
允许的父级 | Any element that accepts flow content. |
隐含的 ARIA 角色 | list |
允许的 ARIA 角色 | {{ARIARole("directory")}}, {{ARIARole("group")}}, {{ARIARole("listbox")}}, {{ARIARole("menu")}}, {{ARIARole("menubar")}}, {{ARIARole("none")}}, {{ARIARole("presentation")}}, {{ARIARole("radiogroup")}}, {{ARIARole("tablist")}}, {{ARIARole("toolbar")}}, {{ARIARole("tree")}} |
DOM 接口 | {{DOMxRef("HTMLOListElement")}} |
此元素支持全局属性。
type
属性可能指定为了罗马数字编号等其他类型的编号。比如说,想要让元素的编号从英文字母 "d" 或者罗马数字 "iv" 开始,都应当使用 start="4"
。
a
表示小写英文字母编号A
表示大写英文字母编号i
表示小写罗马数字编号I
表示大写罗马数字编号1
表示数字编号(默认)编号类型适用于整个列表,除非在 <ol>
元素的 {{HTMLElement("li")}} 元素中使用不同的 {{HTMLAttrxRef("type", "li")}} 属性。
通常,有序列表的条目会和它前面的编号标记一起显示,编号标记可以是数字或者字母。
<ol>
和 {{HTMLElement("ul")}} 元素两者可以无限嵌套,既可以同类嵌套,也可以互相嵌套。
<ol>
和 {{HTMLElement("ul")}} 元素都表示列表。区别在于,<ol>
元素的有序列表的顺序是有意义的。举一些例子:
至于如何确定该选择哪一个列表元素,可以尝试更改列表项的顺序,如果其含义会发生改变,那么就应当使用 {{HTMLElement("ol")}} 元素,否则使用 {{HTMLElement("ul")}} 更合适。
译者注:“更改顺序”时,不应当算上一些固定位于列表最前或最后的项,比如未完成的列表最后的占位项。
如果只有一个元素,以至于根本不存在什么顺序可言,可能最好先考虑是否应当使用列表元素,以及是否要在列表最后增加一些占位的空项。
<ol> <li>Fee</li> <li>Fi</li> <li>Fo</li> <li>Fum</li> </ol>
以上 HTML 输出如下:
{{EmbedLiveSample("Simple_example", 400, 100)}}
<ol type="i"> <li>Introduction</li> <li>List of Greivances</li> <li>Conclusion</li> </ol>
以上 HTML 输出如下:
{{EmbedLiveSample("Using_Roman_Numeral_type", 400, 100)}}
start
属性<p>Finishing places of contestants not in the winners’ circle:</p> <ol start="4"> <li>Speedwalk Stu</li> <li>Saunterin’ Sam</li> <li>Slowpoke Rodriguez</li> </ol>
以上 HTML 输出如下:
{{EmbedLiveSample("Using_the_start_attribute", 400, 100)}}
<ol> <li>first item</li> <li>second item <!-- closing </li> tag not here! --> <ol> <li>second item first subitem</li> <li>second item second subitem</li> <li>second item third subitem</li> </ol> </li> <!-- Here's the closing </li> tag --> <li>third item</li> </ol>
以上 HTML 输出如下:
{{EmbedLiveSample("Nesting_lists", 400, 150)}}
<ol> <li>first item</li> <li>second item <!-- closing </li> tag not here! --> <ul> <li>second item first subitem</li> <li>second item second subitem</li> <li>second item third subitem</li> </ul> </li> <!-- Here's the closing </li> tag --> <li>third item</li> </ol>
以上 HTML 输出如下:
{{EmbedLiveSample("Unordered_list_inside_ordered_list", 400, 150)}}
规范 | 状态 | 备注 |
---|---|---|
{{SpecName('HTML WHATWG', 'semantics.html#the-ol-element', '<ol>')}} | {{Spec2('HTML WHATWG')}} | No change since last W3C snapshot, {{SpecName('HTML5 W3C')}}. |
{{SpecName('HTML5 W3C', "grouping-content.html#the-ol-element", "HTMLOListElement")}} | {{Spec2('HTML5 W3C')}} | Added reversed and start attributed; un-deprecated type |
{{SpecName('HTML4.01', 'struct/lists.html#h-10.2', '<ol>')}} | {{Spec2('HTML4.01')}} | Deprecated compact and type . |
{{Compat("html.elements.ol")}}
<ol>
元素常用的 CSS 属性: