面向 Web 开发人员版 — 最后更新时间 2024 年 9 月 12 日
p
元素在所有当前引擎中受支持。
p
元素紧接在 address
、article
、aside
、blockquote
、details
、dialog
、div
、dl
、fieldset
、figcaption
、figure
、footer
、form
、h1
、h2
、h3
、h4
、h5
、h6
、header
、hgroup
、hr
、main
、menu
、nav
、ol
、p
、pre
、search
、section
、table
或 ul
元素之后,或者如果父元素中没有更多内容,并且父元素是 HTML 元素,而不是 a
、audio
、del
、ins
、map
、noscript
或 video
元素,或者 自治自定义元素,则可以省略 p
元素的 结束标签。HTMLParagraphElement
。虽然段落通常在视觉媒体中通过文本块来表示,这些文本块在物理上通过空行与相邻的块隔开,但样式表或用户代理也有同样合理的理由以其他方式呈现段落断行,例如使用内联分段符号 (¶)。
以下示例是符合规范的 HTML 片段
< p > The little kitten gently seated herself on a piece of
carpet. Later in her life, this would be referred to as the time the
cat sat on the mat.</ p >
< fieldset >
< legend > Personal information</ legend >
< p >
< label > Name: < input name = "n" ></ label >
< label >< input name = "anon" type = "checkbox" > Hide from other users</ label >
</ p >
< p >< label > Address: < textarea name = "a" ></ textarea ></ label ></ p >
</ fieldset >
< p > There was once an example from Femley,< br >
Whose markup was of dubious quality.< br >
The validator complained,< br >
So the author was pained,< br >
To move the error from the markup to the rhyming.</ p >
当更具体的元素更合适时,不应使用
元素。p
以下示例在技术上是正确的
< section >
<!-- ... -->
< p > Last modified: 2001-04-23</ p >
< p > Author: [email protected]</ p >
</ section >
但是,最好将其标记为
< section >
<!-- ... -->
< footer > Last modified: 2001-04-23</ footer >
< address > Author: [email protected]</ address >
</ section >
或者
< section >
<!-- ... -->
< footer >
< p > Last modified: 2001-04-23</ p >
< address > Author: [email protected]</ address >
</ footer >
</ section >
列表元素(特别是 ol
和 ul
元素)不能是
元素的子元素。因此,当一个句子包含一个无序列表时,人们可能会想知道如何标记它。p
例如,这个很棒的句子包含与以下内容相关的项目符号
并在下面进一步讨论。
解决方案是意识到,从 HTML 术语来说,段落不是一个逻辑概念,而是一个结构概念。在上面的精彩示例中,实际上有五个由本规范定义的段落:一个在列表之前,每个项目符号一个,以及一个在列表之后。
因此,上面示例的标记可以是
< p > For instance, this fantastic sentence has bullets relating to</ p >
< ul >
< li > wizards,
< li > faster-than-light travel, and
< li > telepathy,
</ ul >
< p > and is further discussed below.</ p >
希望方便地为包含多个“结构性”段落的这种“逻辑性”段落设置样式的作者可以使用
元素,而不是 div
元素。p
因此,例如,上面的示例可以变成以下内容
< div > For instance, this fantastic sentence has bullets relating to
< ul >
< li > wizards,
< li > faster-than-light travel, and
< li > telepathy,
</ ul >
and is further discussed below.</ div >
此示例仍然有五个结构性段落,但现在作者只需为
设置样式,而不必分别考虑示例的每个部分。div
hr
元素在所有当前引擎中受支持。
select
元素的子元素。HTMLHRElement
。
元素 表示 一段 段落 级别的主题断行,例如故事中的场景变化,或参考书某一节中到另一个主题的过渡;或者,它表示 hr
元素中的一组选项之间的分隔符。select
以下来自项目手册的虚构摘录显示了两个使用
元素分隔节内主题的节。hr
< section >
< h1 > Communication</ h1 >
< p > There are various methods of communication. This section
covers a few of the important ones used by the project.</ p >
< hr >
< p > Communication stones seem to come in pairs and have mysterious
properties:</ p >
< ul >
< li > They can transfer thoughts in two directions once activated
if used alone.</ li >
< li > If used with another device, they can transfer one's
consciousness to another body.</ li >
< li > If both stones are used with another device, the
consciousnesses switch bodies.</ li >
</ ul >
< hr >
< p > Radios use the electromagnetic spectrum in the meter range and
longer.</ p >
< hr >
< p > Signal flares use the electromagnetic spectrum in the
nanometer range.</ p >
</ section >
< section >
< h1 > Food</ h1 >
< p > All food at the project is rationed:</ p >
< dl >
< dt > Potatoes</ dt >
< dd > Two per day</ dd >
< dt > Soup</ dt >
< dd > One bowl per day</ dd >
</ dl >
< hr >
< p > Cooking is done by the chefs on a set rotation.</ p >
</ section >
以下摘录来自彼得·F·汉密尔顿的《潘多拉之星》,展示了两个在场景变化之前的段落和场景变化之后的段落。场景变化在印刷书籍中由一个包含一颗居中星的间隙表示(在第二段和第三段之间),这里使用
元素表示。hr
< p > Dudley was ninety-two, in his second life, and fast approaching
time for another rejuvenation. Despite his body having the physical
age of a standard fifty-year-old, the prospect of a long degrading
campaign within academia was one he regarded with dread. For a
supposedly advanced civilization, the Intersolar Commonwealth could be
appallingly backward at times, not to mention cruel.</ p >
< p >< i > Maybe it won't be that bad</ i > , he told himself. The lie was
comforting enough to get him through the rest of the night's
shift.</ p >
< hr >
< p > The Carlton AllLander drove Dudley home just after dawn. Like the
astronomer, the vehicle was old and worn, but perfectly capable of
doing its job. It had a cheap diesel engine, common enough on a
semi-frontier world like Gralmond, although its drive array was a
thoroughly modern photoneural processor. With its high suspension and
deep-tread tyres it could plough along the dirt track to the
observatory in all weather and seasons, including the metre-deep snow
of Gralmond's winters.</ p >
pre
元素在所有当前引擎中受支持。
HTMLPreElement
。
元素 表示 一块预格式化的文本,其中结构由排版约定而不是元素表示。pre
在 HTML 语法 中,紧接在
元素开始标签之后的第一个换行符会被剥离。pre
以下是一些可以使用
元素的示例pre
鼓励作者考虑在格式丢失时预格式化文本将如何呈现,例如使用语音合成器、盲文显示器等的用户。对于 ASCII 艺术等情况,文本描述等替代呈现方式可能更适合所有读者。
要表示一段计算机代码,可以使用带有code
元素的pre
元素;要表示一段计算机输出,可以使用带有samp
元素的pre
元素。类似地,kbd
元素可以在pre
元素内使用,以指示用户要输入的文本。
在以下片段中,展示了一个计算机代码示例。
< p > This is the < code > Panel</ code > constructor:</ p >
< pre >< code > function Panel(element, canClose, closeHandler) {
this.element = element;
this.canClose = canClose;
this.closeHandler = function () { if (closeHandler) closeHandler() };
}</ code ></ pre >
在以下片段中,samp
和 kbd
元素混合在 pre
元素的内容中,以显示 Zork I 的一个会话。
< pre >< samp > You are in an open field west of a big white house with a boarded
front door.
There is a small mailbox here.
></ samp > < kbd > open mailbox</ kbd >
< samp > Opening the mailbox reveals:
A leaflet.
></ samp ></ pre >
以下展示了一首当代诗歌,它使用 pre
元素来保留其不寻常的格式,这构成了诗歌本身的内在部分。
< pre > maxling
it is with a heart
heavy
that i admit loss of a feline
so loved
a friend lost to the
unknown
(night)
~cdr 11dec07</ pre >
blockquote
元素在所有当前引擎中受支持。
cite
— 引用来源或编辑信息的链接HTMLQuoteElement
。The blockquote
元素 表示 从另一个来源引用的部分。
内的内容必须来自另一个来源,其地址(如果有)可以在 blockquote
cite
属性中引用。
如果存在 cite
属性,它必须是 有效的 URL,可能被空格包围。用户代理可能允许用户跟踪此类引用链接,但它们主要用于私人用途(例如,由服务器端脚本收集有关网站引用使用情况的统计信息),而不是供读者使用。
的内容可以是缩写,也可以以文本语言的传统方式添加上下文。blockquote
例如,在英语中,这通常使用方括号完成。考虑一个包含句子“Jane ate the cracker. She then said she liked apples and fish.”的页面;它可以引用如下
< blockquote >
< p > [Jane] then said she liked [...] fish.</ p >
</ blockquote >
引用(如果有)的归属必须放在blockquote
元素之外。
例如,这里归属在引用后的段落中给出
< blockquote >
< p > I contend that we are both atheists. I just believe in one fewer
god than you do. When you understand why you dismiss all the other
possible gods, you will understand why I dismiss yours.</ p >
</ blockquote >
< p > — Stephen Roberts</ p >
下面的其他示例展示了其他显示归属的方式。
这里,blockquote
元素与 figure
元素及其 figcaption
结合使用,以清楚地将引用与其归属关联起来(归属不是引用的一部分,因此不属于 blockquote
本身)
< figure >
< blockquote >
< p > The truth may be puzzling. It may take some work to grapple with.
It may be counterintuitive. It may contradict deeply held
prejudices. It may not be consonant with what we desperately want to
be true. But our preferences do not determine what's true. We have a
method, and that method helps us to reach not absolute truth, only
asymptotic approaches to the truth — never there, just closer
and closer, always finding vast new oceans of undiscovered
possibilities. Cleverly designed experiments are the key.</ p >
</ blockquote >
< figcaption > Carl Sagan, in "< cite > Wonder and Skepticism</ cite > ", from
the < cite > Skeptical Inquirer</ cite > Volume 19, Issue 1 (January-February
1995)</ figcaption >
</ figure >
下一个示例展示了 cite
以及 blockquote
的使用方式
< p > His next piece was the aptly named < cite > Sonnet 130</ cite > :</ p >
< blockquote cite = "https://quotes.example.org/s/sonnet130.html" >
< p > My mistress' eyes are nothing like the sun,< br >
Coral is far more red, than her lips red,< br >
...
此示例展示了论坛帖子如何使用 blockquote
来显示用户回复的帖子。对于每个帖子,使用 article
元素来标记线程。
< article >
< h1 >< a href = "https://bacon.example.com/?blog=109431" > Bacon on a crowbar</ a ></ h1 >
< article >
< header >< strong > t3yw</ strong > 12 points 1 hour ago</ header >
< p > I bet a narwhal would love that.</ p >
< footer >< a href = "?pid=29578" > permalink</ a ></ footer >
< article >
< header >< strong > greg</ strong > 8 points 1 hour ago</ header >
< blockquote >< p > I bet a narwhal would love that.</ p ></ blockquote >
< p > Dude narwhals don't eat bacon.</ p >
< footer >< a href = "?pid=29579" > permalink</ a ></ footer >
< article >
< header >< strong > t3yw</ strong > 15 points 1 hour ago</ header >
< blockquote >
< blockquote >< p > I bet a narwhal would love that.</ p ></ blockquote >
< p > Dude narwhals don't eat bacon.</ p >
</ blockquote >
< p > Next thing you'll be saying they don't get capes and wizard
hats either!</ p >
< footer >< a href = "?pid=29580" > permalink</ a ></ footer >
< article >
< article >
< header >< strong > boing</ strong > -5 points 1 hour ago</ header >
< p > narwhals are worse than ceiling cat</ p >
< footer >< a href = "?pid=29581" > permalink</ a ></ footer >
</ article >
</ article >
</ article >
</ article >
< article >
< header >< strong > fred</ strong > 1 points 23 minutes ago</ header >
< blockquote >< p > I bet a narwhal would love that.</ p ></ blockquote >
< p > I bet they'd love to peel a banana too.</ p >
< footer >< a href = "?pid=29582" > permalink</ a ></ footer >
</ article >
</ article >
</ article >
此示例展示了将 blockquote
用于短片段,演示了不必在 blockquote
元素内使用 p
元素
< p > He began his list of "lessons" with the following:</ p >
< blockquote > One should never assume that his side of
the issue will be recognized, let alone that it will
be conceded to have merits.</ blockquote >
< p > He continued with a number of similar points, ending with:</ p >
< blockquote > Finally, one should be prepared for the threat
of breakdown in negotiations at any given moment and not
be cowed by the possibility.</ blockquote >
< p > We shall now discuss these points...
如何表示对话的示例 在后面的部分中展示;不适合为此目的使用 cite
和 blockquote
元素。
ol
元素在所有当前引擎中受支持。
li
元素:可感知内容。li
和 脚本支持 元素。reversed
— 倒序编号列表start
— 起始值 列表type
— 列表标记类型HTMLOListElement
。The ol
元素 表示 项目列表,其中项目已有意排序,因此更改顺序将更改文档的含义。
列表的项目是 li
元素,它是 ol
元素的子节点,按 树序 排列。
在所有当前引擎中受支持。
The reversed
属性是 布尔属性。如果存在,它表示列表是降序列表(..., 3, 2, 1)。如果省略该属性,列表是升序列表 (1, 2, 3, ...)。
The start
属性(如果存在)必须是 有效的整数。它用于确定列表的 起始值。
The type
属性可用于指定在列表中使用的标记类型,在这些情况下(例如,因为项目要通过其编号/字母进行 引用)。如果指定了该属性,其值必须 与 下表中某一行第一列中给出的字符之一相同。
关键字 | 状态 | 描述 | 值 1-3 和 3999-4001 的示例 | |||||||
---|---|---|---|---|---|---|---|---|---|---|
1 (U+0031) | decimal | 十进制数 | 1. | 2. | 3. | ... | 3999. | 4000. | 4001. | ... |
a (U+0061) | lower-alpha | 小写拉丁字母 | a. | b. | c. | ... | ewu. | ewv. | eww. | ... |
A (U+0041) | upper-alpha | 大写拉丁字母 | A. | B. | C. | ... | EWU. | EWV. | EWW. | ... |
i (U+0069) | lower-roman | 小写罗马数字 | i. | ii. | iii. | ... | mmmcmxcix. | i̅v̅. | i̅v̅i. | ... |
I (U+0049) | upper-roman | 大写罗马数字 | I. | II. | III. | ... | MMMCMXCIX. | I̅V̅. | I̅V̅I. | ... |
可以在 CSS 用户代理中重新定义用于实现此属性的默认 CSS 列表样式;这样做会影响列表项的呈现方式。
以下标记展示了一个顺序很重要的列表,因此 ol
元素是合适的。将此列表与 ul
部分中的等效列表进行比较,以查看使用 ul
元素的相同项目的示例。
< p > I have lived in the following countries (given in the order of when
I first lived there):</ p >
< ol >
< li > Switzerland
< li > United Kingdom
< li > United States
< li > Norway
</ ol >
请注意,更改列表的顺序会更改文档的含义。在以下示例中,更改前两项的相对顺序改变了作者的出生地
< p > I have lived in the following countries (given in the order of when
I first lived there):</ p >
< ol >
< li > United Kingdom
< li > Switzerland
< li > United States
< li > Norway
</ ol >
ul
元素在所有当前引擎中受支持。
li
元素:可感知内容。li
和 脚本支持 元素。HTMLUListElement
。The ul
元素 表示 项目列表,其中项目的顺序并不重要,也就是说,更改顺序不会实质性地改变文档的含义。
以下标记展示了一个顺序不重要的列表,因此 ul
元素是合适的。将此列表与 ol
部分中的等效列表进行比较,以查看使用 ol
元素的相同项目的示例。
< p > I have lived in the following countries:</ p >
< ul >
< li > Norway
< li > Switzerland
< li > United Kingdom
< li > United States
</ ul >
请注意,更改列表的顺序不会更改文档的含义。以上代码段中的项目按字母顺序排列,但在下面的代码段中,它们按 2007 年当前账户余额的大小排列,而不会改变文档的含义
< p > I have lived in the following countries:</ p >
< ul >
< li > Switzerland
< li > Norway
< li > United Kingdom
< li > United States
</ ul >
menu
元素在所有当前引擎中受支持。
li
元素:可感知内容。li
和 脚本支持 元素。HTMLMenuElement
。menu
元素 表示 一个工具栏,它由其内容组成,这些内容以无序列表的形式呈现(由 li
元素表示),每个元素都代表用户可以执行或激活的命令。
menu
元素只是 ul
的语义替代品,用于表达命令的无序列表(“工具栏”)。
在这个例子中,一个文本编辑应用程序使用一个 menu
元素来提供一系列编辑命令。
< menu >
< li >< button onclick = "copy()" >< img src = "copy.svg" alt = "Copy" ></ button ></ li >
< li >< button onclick = "cut()" >< img src = "cut.svg" alt = "Cut" ></ button ></ li >
< li >< button onclick = "paste()" >< img src = "paste.svg" alt = "Paste" ></ button ></ li >
</ menu >
请注意,要使它看起来像传统的工具栏菜单,样式由应用程序决定。
li
元素 在所有当前引擎中受支持。
ol
元素内部。ul
元素内部。menu
元素内部。li
元素紧随其后是另一个 li
元素,或者父元素中没有更多内容,则可以省略 li
元素的 结束标签。ul
或 menu
元素的子元素:value
— 列表项的序数值HTMLLIElement
。li
元素 表示 列表项。如果其父元素是 ol
、ul
或 menu
元素,则该元素是父元素列表中的一个项目,如这些元素的定义所示。否则,列表项与任何其他 li
元素之间没有定义的列表相关关系。
如果存在,value
属性必须是 有效的整数。当 li
的 列表所有者 是 ol
元素时,它用于确定列表项的 序数值。
在以下示例中,列出了前十部电影(按倒序排列)。请注意,使用 figure
元素及其 figcaption
元素为列表添加标题。
< figure >
< figcaption > The top 10 movies of all time</ figcaption >
< ol >
< li value = "10" >< cite > Josie and the Pussycats</ cite > , 2001</ li >
< li value = "9" >< cite lang = "sh" > Црна мачка, бели мачор</ cite > , 1998</ li >
< li value = "8" >< cite > A Bug's Life</ cite > , 1998</ li >
< li value = "7" >< cite > Toy Story</ cite > , 1995</ li >
< li value = "6" >< cite > Monsters, Inc</ cite > , 2001</ li >
< li value = "5" >< cite > Cars</ cite > , 2006</ li >
< li value = "4" >< cite > Toy Story 2</ cite > , 1999</ li >
< li value = "3" >< cite > Finding Nemo</ cite > , 2003</ li >
< li value = "2" >< cite > The Incredibles</ cite > , 2004</ li >
< li value = "1" >< cite > Ratatouille</ cite > , 2007</ li >
</ ol >
</ figure >
可以使用 ol
元素上的 reversed
属性以如下方式编写标记。
< figure >
< figcaption > The top 10 movies of all time</ figcaption >
< ol reversed >
< li >< cite > Josie and the Pussycats</ cite > , 2001</ li >
< li >< cite lang = "sh" > Црна мачка, бели мачор</ cite > , 1998</ li >
< li >< cite > A Bug's Life</ cite > , 1998</ li >
< li >< cite > Toy Story</ cite > , 1995</ li >
< li >< cite > Monsters, Inc</ cite > , 2001</ li >
< li >< cite > Cars</ cite > , 2006</ li >
< li >< cite > Toy Story 2</ cite > , 1999</ li >
< li >< cite > Finding Nemo</ cite > , 2003</ li >
< li >< cite > The Incredibles</ cite > , 2004</ li >
< li >< cite > Ratatouille</ cite > , 2007</ li >
</ ol >
</ figure >
虽然在 li
元素内部包含标题元素(例如 h1
)是符合规范的,但它可能无法传达作者的意图。标题开始一个新的部分,因此列表中的标题隐式地将列表分成多个部分。
dl
元素 在所有当前引擎中受支持。
dt
元素,后跟一个或多个 dd
元素,可以选择与 脚本支持元素 交织在一起。div
元素,可以选择与 脚本支持元素 交织在一起。HTMLDListElement
。dl
元素 表示 一个关联列表,它包含零个或多个名称-值对(描述列表)。名称-值对包含一个或多个名称(dt
元素,可能作为 div
元素子元素的子元素),后跟一个或多个值(dd
元素,可能作为 div
元素子元素的子元素),忽略除 dt
和 dd
元素子元素之外的任何节点,以及 dt
和 dd
元素,它们是 div
元素子元素的子元素。在一个 dl
元素内,每个名称不应该有多于一个 dt
元素。
名称-值对可以是术语和定义、元数据主题和值、问题和答案,或任何其他名称-值数据的组。
组内的值是备选方案;构成相同值的多个段落必须全部在同一个 dd
元素内给出。
组列表的顺序以及每个组内名称和值的顺序可能很重要。
为了使用 微数据 属性或其他 全局属性 对组进行注释,或者仅出于样式目的,dl
元素中的每个组都可以用 div
元素包装。这不会改变 dl
元素的语义。
在以下示例中,一个条目(“作者”)链接到两个值(“John”和“Luke”)。
< dl >
< dt > Authors
< dd > John
< dd > Luke
< dt > Editor
< dd > Frank
</ dl >
在以下示例中,一个定义链接到两个术语。
< dl >
< dt lang = "en-US" > < dfn > color</ dfn > </ dt >
< dt lang = "en-GB" > < dfn > colour</ dfn > </ dt >
< dd > A sensation which (in humans) derives from the ability of
the fine structure of the eye to distinguish three differently
filtered analyses of a view. </ dd >
</ dl >
以下示例说明了使用 dl
元素来标记元数据。在示例的末尾,一个组有两个元数据标签(“作者”和“编辑”)和两个值(“Robert Rothman”和“Daniel Jackson”)。本示例还使用 div
元素围绕 dt
和 dd
元素的组,以帮助进行样式设置。
< dl >
< div >
< dt > Last modified time </ dt >
< dd > 2004-12-23T23:33Z </ dd >
</ div >
< div >
< dt > Recommended update interval </ dt >
< dd > 60s </ dd >
</ div >
< div >
< dt > Authors </ dt >
< dt > Editors </ dt >
< dd > Robert Rothman </ dd >
< dd > Daniel Jackson </ dd >
</ div >
</ dl >
以下示例展示了 dl
元素用于提供一组说明。这里说明的顺序很重要(在其他示例中,块的顺序并不重要)。
< p > Determine the victory points as follows (use the
first matching case):</ p >
< dl >
< dt > If you have exactly five gold coins </ dt >
< dd > You get five victory points </ dd >
< dt > If you have one or more gold coins, and you have one or more silver coins </ dt >
< dd > You get two victory points </ dd >
< dt > If you have one or more silver coins </ dt >
< dd > You get one victory point </ dd >
< dt > Otherwise </ dt >
< dd > You get no victory points </ dd >
</ dl >
以下代码片段展示了 dl
元素用作词汇表。请注意使用 dfn
来指示要定义的词语。
< dl >
< dt >< dfn > Apartment</ dfn > , n.</ dt >
< dd > An execution context grouping one or more threads with one or
more COM objects.</ dd >
< dt >< dfn > Flat</ dfn > , n.</ dt >
< dd > A deflated tire.</ dd >
< dt >< dfn > Home</ dfn > , n.</ dt >
< dd > The user's login directory.</ dd >
</ dl >
本示例在 dl
元素中使用 微数据 属性以及 div
元素,以注释一家法国餐厅的冰淇淋甜点。
< dl >
< div itemscope itemtype = "http://schema.org/Product" >
< dt itemprop = "name" > Café ou Chocolat Liégeois
< dd itemprop = "offers" itemscope itemtype = "http://schema.org/Offer" >
< span itemprop = "price" > 3.50</ span >
< data itemprop = "priceCurrency" value = "EUR" > €</ data >
< dd itemprop = "description" >
2 boules Café ou Chocolat, 1 boule Vanille, sauce café ou chocolat, chantilly
</ div >
< div itemscope itemtype = "http://schema.org/Product" >
< dt itemprop = "name" > Américaine
< dd itemprop = "offers" itemscope itemtype = "http://schema.org/Offer" >
< span itemprop = "price" > 3.50</ span >
< data itemprop = "priceCurrency" value = "EUR" > €</ data >
< dd itemprop = "description" >
1 boule Crème brûlée, 1 boule Vanille, 1 boule Caramel, chantilly
</ div >
</ dl >
如果没有 div
元素,标记需要使用 itemref
属性将 dd
元素中的数据链接到项目,如下所示。
< dl >
< dt itemscope itemtype = "http://schema.org/Product" itemref = "1-offer 1-description" >
< span itemprop = "name" > Café ou Chocolat Liégeois</ span >
< dd id = "1-offer" itemprop = "offers" itemscope itemtype = "http://schema.org/Offer" >
< span itemprop = "price" > 3.50</ span >
< data itemprop = "priceCurrency" value = "EUR" > €</ data >
< dd id = "1-description" itemprop = "description" >
2 boules Café ou Chocolat, 1 boule Vanille, sauce café ou chocolat, chantilly
< dt itemscope itemtype = "http://schema.org/Product" itemref = "2-offer 2-description" >
< span itemprop = "name" > Américaine</ span >
< dd id = "2-offer" itemprop = "offers" itemscope itemtype = "http://schema.org/Offer" >
< span itemprop = "price" > 3.50</ span >
< data itemprop = "priceCurrency" value = "EUR" > €</ data >
< dd id = "2-description" itemprop = "description" >
1 boule Crème brûlée, 1 boule Vanille, 1 boule Caramel, chantilly
</ dl >
dl
元素不适合用于标记对话。请参见 如何标记对话的一些示例。
dt
元素 在所有当前引擎中受支持。
dd
或 dt
元素之前,位于 dl
元素内部。dd
或 dt
元素之前,位于 dl
元素的子元素 div
元素内部。header
、footer
、分段内容 或 标题内容 后代。dt
元素紧随其后是另一个 dt
元素或一个 dd
元素,则可以省略 dt
元素的 结束标签。HTMLElement
。dt
元素 表示 描述列表(dl
元素)中术语-描述组的术语或名称部分。
dt
元素本身在 dl
元素中使用时,不表示其内容是正在定义的术语,但这可以使用 dfn
元素来表示。
本示例展示了使用 dt
元素表示问题和 dd
元素表示答案来标记常见问题解答(FAQ)列表。
< article >
< h1 > FAQ</ h1 >
< dl >
< dt > What do we want?</ dt >
< dd > Our data.</ dd >
< dt > When do we want it?</ dt >
< dd > Now.</ dd >
< dt > Where is it?</ dt >
< dd > We are not sure.</ dd >
</ dl >
</ article >
dd
元素 在所有当前引擎中受支持。
dt
或 dd
元素之后,位于 dl
元素内部。dl
元素的子元素 div
元素内部, dt
或 dd
元素之后。dd
元素紧随其后的是另一个 dd
元素或一个 dt
元素,或者父元素中没有更多内容,则可以省略 dd
元素的 结束标签。HTMLElement
。dd
元素 表示 描述列表 (dl
元素) 中术语-描述组的描述、定义或值部分。
dl
可以用来定义词汇表,例如字典。在以下示例中,每个条目由一个带有 dfn
的 dt
给出,并包含多个 dd
,显示定义的各个部分。
< dl >
< dt >< dfn > happiness</ dfn ></ dt >
< dd class = "pronunciation" > /ˈhæpinəs/</ dd >
< dd class = "part-of-speech" >< i >< abbr > n.</ abbr ></ i ></ dd >
< dd > The state of being happy.</ dd >
< dd > Good fortune; success. < q > Oh < b > happiness</ b > ! It worked!</ q ></ dd >
< dt >< dfn > rejoice</ dfn ></ dt >
< dd class = "pronunciation" > /rɪˈdʒɔɪs/</ dd >
< dd >< i class = "part-of-speech" >< abbr > v.intr.</ abbr ></ i > To be delighted oneself.</ dd >
< dd >< i class = "part-of-speech" >< abbr > v.tr.</ abbr ></ i > To cause one to be delighted.</ dd >
</ dl >
figure
元素在所有当前引擎中受支持。
figcaption
元素,后跟 流内容。figcaption
元素。HTMLElement
。figure
元素 表示 一些 流内容,可以选择性地包含标题,这些内容是自包含的(就像完整的句子一样),通常作为单个单元 被引用,来自文档的主流程。
在此上下文中,“自包含”并不一定意味着独立。例如,段落中的每个句子都是自包含的;属于句子的图像不适合 figure
,但整个句子由图像组成就很合适。
因此,该元素可用于注释插图、图表、照片、代码清单等。
当文档的主内容通过标识其标题(例如,通过图号)引用 figure
时,它使这些内容能够轻松地从该主要内容中移开,例如,移到页面旁边、专门的页面或附录中,而不会影响文档的流程。
如果 figure
元素通过其相对位置 被引用,例如,“在上面的照片中”或“如下一张图所示”,则移动该图形将破坏页面的含义。鼓励作者考虑使用标签来引用图形,而不是使用此类相对引用,以便可以轻松地重新设置页面样式,而不会影响页面的含义。
如果存在 figcaption
元素,它是该元素的子元素,则它表示 figure
元素内容的标题。如果没有子 figcaption
元素,则没有标题。
figure
元素的内容是周围流的一部分。如果页面的目的是显示该图形,例如图像共享网站上的照片,则可以使用 figure
和 figcaption
元素明确地为该图形提供标题。对于仅与周围流间接相关或服务于与周围流不同的目的的内容,应使用 aside
元素(并且它本身可以包装一个 figure
)。例如,从 article
中重复内容的摘录放在 aside
中比放在 figure
中更合适,因为它不是内容的一部分,它是为了吸引读者或突出重点主题而重复内容。
此示例显示 figure
元素用于标记代码清单。
< p > In < a href = "#l4" > listing 4</ a > we see the primary core interface
API declaration.</ p >
< figure id = "l4" >
< figcaption > Listing 4. The primary core interface API declaration.</ figcaption >
< pre >< code > interface PrimaryCore {
boolean verifyDataLine();
undefined sendData(sequence< byte> data);
undefined initSelfDestruct();
}</ code ></ pre >
</ figure >
< p > The API is designed to use UTF-8.</ p >
在这里,我们看到一个 figure
元素用于标记照片,该照片是页面的主要内容(如在图库中)。
<!DOCTYPE HTML>
< html lang = "en" >
< title > Bubbles at work — My Gallery™</ title >
< figure >
< img src = "bubbles-work.jpeg"
alt = "Bubbles, sitting in his office chair, works on his
latest project intently." >
< figcaption > Bubbles at work</ figcaption >
</ figure >
< nav >< a href = "19414.html" > Prev</ a > — < a href = "19416.html" > Next</ a ></ nav >
在此示例中,我们看到一个不是图形的图像,以及一个图像和一个视频,它们是图形。第一个图像实际上是示例的第二个句子的部分,因此它不是一个自包含的单元,因此 figure
不合适。
< h2 > Malinko's comics</ h2 >
< p > This case centered on some sort of "intellectual property"
infringement related to a comic (see Exhibit A). The suit started
after a trailer ending with these words:
< blockquote >
< img src = "promblem-packed-action.png" alt = "ROUGH COPY! Promblem-Packed Action!" >
</ blockquote >
< p > ...was aired. A lawyer, armed with a Bigger Notebook, launched a
preemptive strike using snowballs. A complete copy of the trailer is
included with Exhibit B.
< figure >
< img src = "ex-a.png" alt = "Two squiggles on a dirty piece of paper." >
< figcaption > Exhibit A. The alleged < cite > rough copy</ cite > comic.</ figcaption >
</ figure >
< figure >
< video src = "ex-b.mov" ></ video >
< figcaption > Exhibit B. The < cite > Rough Copy</ cite > trailer.</ figcaption >
</ figure >
< p > The case was resolved out of court.
在这里,诗歌的一部分使用 figure
标记。
< figure >
< p > 'Twas brillig, and the slithy toves< br >
Did gyre and gimble in the wabe;< br >
All mimsy were the borogoves,< br >
And the mome raths outgrabe.</ p >
< figcaption >< cite > Jabberwocky</ cite > (first verse). Lewis Carroll, 1832-98</ figcaption >
</ figure >
在此示例中,它可能是讨论城堡的更大作品的一部分,嵌套的 figure
元素用于为组中的每个图形提供组标题和单个标题。
< figure >
< figcaption > The castle through the ages: 1423, 1858, and 1999 respectively.</ figcaption >
< figure >
< figcaption > Etching. Anonymous, ca. 1423.</ figcaption >
< img src = "castle1423.jpeg" alt = "The castle has one tower, and a tall wall around it." >
</ figure >
< figure >
< figcaption > Oil-based paint on canvas. Maria Towle, 1858.</ figcaption >
< img src = "castle1858.jpeg" alt = "The castle now has two towers and two walls." >
</ figure >
< figure >
< figcaption > Film photograph. Peter Jankle, 1999.</ figcaption >
< img src = "castle1999.jpeg" alt = "The castle lies in ruins, the original tower all that remains in one piece." >
</ figure >
</ figure >
前面的示例也可以更简洁地写成如下(使用 title
属性代替嵌套的 figure
/figcaption
对)。
< figure >
< img src = "castle1423.jpeg" title = "Etching. Anonymous, ca. 1423."
alt = "The castle has one tower, and a tall wall around it." >
< img src = "castle1858.jpeg" title = "Oil-based paint on canvas. Maria Towle, 1858."
alt = "The castle now has two towers and two walls." >
< img src = "castle1999.jpeg" title = "Film photograph. Peter Jankle, 1999."
alt = "The castle lies in ruins, the original tower all that remains in one piece." >
< figcaption > The castle through the ages: 1423, 1858, and 1999 respectively.</ figcaption >
</ figure >
图形有时仅通过内容 隐式引用
< article >
< h1 > Fiscal negotiations stumble in Congress as deadline nears</ h1 >
< figure >
< img src = "obama-reid.jpeg" alt = "Obama and Reid sit together smiling in the Oval Office." >
< figcaption > Barack Obama and Harry Reid. White House press photograph.</ figcaption >
</ figure >
< p > Negotiations in Congress to end the fiscal impasse sputtered on Tuesday, leaving both chambers
grasping for a way to reopen the government and raise the country's borrowing authority with a
Thursday deadline drawing near.</ p >
...
</ article >
figcaption
元素在所有当前引擎中受支持。
figure
元素的第一个或最后一个子元素。HTMLElement
。figcaption
元素 表示 figcaption
元素的父 figure
元素中其余内容的标题或图例。
该元素可以包含有关来源的附加信息
< figcaption >
< p > A duck.</ p >
< p >< small > Photograph courtesy of 🌟 News.</ small ></ p >
</ figcaption >
< figcaption >
< p > Average rent for 3-room apartments, excluding non-profit apartments</ p >
< p > Zürich’s Statistics Office — < time datetime = 2017-11-14 > 14 November 2017</ time ></ p >
</ figcaption >
main
元素在所有当前引擎中受支持。
main
元素。HTMLElement
。文档中不能有多个 main
元素,这些元素没有指定 属性。
结构正确的 main
元素 是指其祖先元素仅限于 html
、body
、div
、form
(没有 可访问名称),以及 自主自定义元素 的元素。每个 main
元素必须是 结构正确的 main
元素。
在此示例中,作者使用了一个演示,其中页面的每个组件都在一个框中呈现。为了包装页面的主要内容(而不是页眉、页脚、导航栏和侧边栏),使用了 main
元素。
<!DOCTYPE html>
< html lang = "en" >
< title > RPG System 17</ title >
< style >
header , nav , aside , main , footer {
margin : 0.5 em ; border : thin solid ; padding : 0.5 em ;
background : #EFF ; color : black ; box-shadow : 0 0 0.25 em #033 ;
}
h1 , h2 , p { margin : 0 ; }
nav , main { float : left ; }
aside { float : right ; }
footer { clear : both ; }
</ style >
< header >
< h1 > System Eighteen</ h1 >
</ header >
< nav >
< a href = "../16/" > ← System 17</ a >
< a href = "../18/" > RPXIX →</ a >
</ nav >
< aside >
< p > This system has no HP mechanic, so there's no healing.
</ aside >
< main >
< h2 > Character creation</ h2 >
< p > Attributes (magic, strength, agility) are purchased at the cost of one point per level.</ p >
< h2 > Rolls</ h2 >
< p > Each encounter, roll the dice for all your skills. If you roll more than the opponent, you win.</ p >
</ main >
< footer >
< p > Copyright © 2013
</ footer >
</ html >
在以下示例中,使用了多个 main
元素,并使用脚本在没有服务器往返的情况下使导航工作,并为非当前元素设置 属性。
<!doctype html>
< html lang = en-CA >
< meta charset = utf-8 >
< title > … </ title >
< link rel = stylesheet href = spa.css >
< script src = spa.js async ></ script >
< nav >
< a href = / > Home</ a >
< a href = /about > About</ a >
< a href = /contact > Contact</ a >
</ nav >
< main >
< h1 > Home</ h1 >
…
</ main >
< main hidden >
< h1 > About</ h1 >
…
</ main >
< main hidden >
< h1 > Contact</ h1 >
…
</ main >
< footer > Made with ❤️ by < a href = https://example.com/ > Example 👻</ a > .</ footer >
search
元素当前引擎不支持。
HTMLElement
。search
元素 表示 文档或应用程序的一部分,其中包含一组与执行搜索或过滤操作相关的表单控件或其他内容。这可能是网站或应用程序的搜索;在当前网页上搜索或过滤搜索结果的方法;或全局或互联网范围的搜索功能。
不建议仅用于呈现搜索结果的 search
元素,尽管作为“快速搜索”结果一部分的建议和链接可以包含在搜索功能中。相反,返回的搜索结果网页将被期望作为该网页的主要内容的一部分呈现。
在以下示例中,作者在网页的 header
中包含一个搜索表单。
< header >
< h1 >< a href = "/" > My fancy blog</ a ></ h1 >
...
< search >
< form action = "search.php" >
< label for = "query" > Find an article</ label >
< input id = "query" name = "q" type = "search" >
< button type = "submit" > Go!</ button >
</ form >
</ search >
</ header >
在这个示例中,作者完全使用 JavaScript 实现其 Web 应用程序的搜索功能。没有使用 表单
元素来执行服务器端提交,但包含的 搜索
元素在语义上标识了后代内容的用途,表示搜索功能。
< search >
< label >
Find and filter your query
< input type = "search" id = "query" >
</ label >
< label >
< input type = "checkbox" id = "exact-only" >
Exact matches only
</ label >
< section >
< h3 > Results found:</ h3 >
< ul id = "results" >
< li >
< p >< a href = "services/consulting" > Consulting services</ a ></ p >
< p >
Find out how can we help you improve your business with our integrated consultants, Bob and Bob.
</ p >
</ li >
...
</ ul >
<!--
when a query returns or filters out all results
render the no results message here
-->
< output id = "no-results" ></ output >
</ section >
</ search >
在以下示例中,页面具有两个搜索功能。第一个位于网页的 头部
中,用作搜索网站内容的全局机制。其目的由其指定的 标题
属性指示。第二个包含在页面的主要内容中,因为它表示搜索和过滤当前页面内容的机制。它包含一个标题来指示其目的。
< body >
< header >
...
< search title = "Website" >
...
</ search >
</ header >
< main >
< h1 > Hotels near your location</ h1 >
< search >
< h2 > Filter results</ h2 >
...
</ search >
< article >
<!-- search result content -->
</ article >
</ main >
</ body >
div
元素在所有当前引擎中受支持。
dl
元素的子元素。dl
元素的子元素:一个或多个 dt
元素,后跟一个或多个 dd
元素,可以选择与 脚本支持元素 交织。dl
元素的子元素:流内容。HTMLDivElement
。div
元素本身没有特殊意义。它 代表 其子元素。它可以与 类
、lang
和 title
属性一起使用,以标记一组连续元素的共同语义。它也可以在 dl
元素中使用,包装一组 dt
和 dd
元素。
强烈建议作者将 div
元素视为最后的手段,当没有其他元素适合时使用。使用更合适的元素而不是 div
元素可以提高读者访问性,并使作者更容易维护。
例如,博客文章将使用 article
进行标记,章节将使用 section
进行标记,页面导航辅助将使用 nav
进行标记,一组表单控件将使用 fieldset
进行标记。
另一方面,div
元素可用于样式目的或包装一个部分中的多个段落,这些段落都以类似的方式进行注释。在以下示例中,我们看到 div
元素用作一次设置两个段落语言的方式,而不是分别在两个段落元素上设置语言。
< article lang = "en-US" >
< h1 > My use of language and my cats</ h1 >
< p > My cat's behavior hasn't changed much since her absence, except
that she plays her new physique to the neighbors regularly, in an
attempt to get pets.</ p >
< div lang = "en-GB" >
< p > My other cat, coloured black and white, is a sweetie. He followed
us to the pool today, walking down the pavement with us. Yesterday
he apparently visited our neighbours. I wonder if he recognises that
their flat is a mirror image of ours.</ p >
< p > Hm, I just noticed that in the last paragraph I used British
English. But I'm supposed to write in American English. So I
shouldn't say "pavement" or "flat" or "colour"...</ p >
</ div >
< p > I should say "sidewalk" and "apartment" and "color"!</ p >
</ article >