大网数据广告活动
Web 标准与前端开发

<header>:标题元素

· 52CE 我爱测

**`<header>`** HTML 元素表示介绍性内容,通常是一组介绍性或导航性辅助内容。它可能包含一些标题元素,也可能包含徽标、搜索表单、作者姓名和其他元素。

<header> HTML 元素表示介绍性内容,通常是一组介绍性或导航性辅助内容。它可能包含一些标题元素,也可能包含徽标、搜索表单、作者姓名和其他元素。

HTML Demo: <header>

<header>
  <a class="logo" href="#">Cute Puppies Express!</a>
</header>

<article>
  <header>
    <h1>Beagles</h1>
    <time>08.12.2014</time>
  </header>
  <p>
    I love beagles <em>so</em> much! Like, really, a lot. They’re adorable and
    their ears are so, so snugly soft!
  </p>
</article>
.logo {
  background: left / cover
    url("/shared-assets/images/examples/puppy-header.jpg");
  display: flex;
  height: 120px;
  align-items: center;
  justify-content: center;
  font:
    bold calc(1em + 2 * (100vw - 120px) / 100) "Dancing Script",
    fantasy;
  color: #ff0083;
  text-shadow: #000 2px 2px 0.2rem;
}

header > h1 {
  margin-bottom: 0;
}

header > time {
  font: italic 0.7rem sans-serif;
}

使用说明

<header> 元素的意义与网站范围内的 banner 地标角色相同,除非嵌套在分段内容内。在这种情况下,<header> 元素不再是地标。

<header> 元素可以定义一个全局站点标题,在无障碍树中描述为 banner。它通常包括一个徽标、公司名称、搜索功能,以及可能的全局导航或标语。它通常位于页面的顶端。

否则,它是在无障碍树中的一个 section,通常包含周围部分的标题(h1 – h6 元素)和可选的副标题,但这并不是必要的。

历史用法

<header> 元素最初在 HTML 的早期用于标题。在第一个网站中可以看到。在某个时间点,标题变成了 <h1> 至 <h6>,使 <header> 可以自由地扮演一个不一样的角色。

属性

此元素包含全局属性。

无障碍

当 <header> 元素的上下文为 body 元素时,它定义了一个 banner 地标。当 HTML 标题元素是 article、aside、main、nav 或 section 元素的后代时,则不视为 banner 地标。

示例

页面标题

<header>
  <h1>主页标题</h1>
  <img src="mdn-logo-sm.png" alt="MDN 徽标" />
</header>

结果

页面标题

文章标题

<article>
  <header>
    <h2>行星地球</h2>
    <p>
      作者:Jane Smith,发布日期:<time datetime="2017-10-04"
        >2017 年 10 月 4 日</time
      >
    </p>
  </header>
  <p>我们生活在一个蓝绿相间的星球上,有许多东西还未曾见过。</p>
  <p><a href="https://example.com/the-planet-earth/">继续阅读……</a></p>
</article>

结果

文章标题

技术概要

<table class="properties"> <tbody> <tr> <th scope="row"> <a href="/zh-CN/docs/Web/HTML/Guides/Content_categories" >内容分类</a > </th> <td> <a href="/zh-CN/docs/Web/HTML/Guides/Content_categories#流式内容" >流式内容</a >、<a href="/zh-CN/docs/Web/HTML/Guides/Content_categories#可感知内容" >可感知内容</a >。 </td> </tr> <tr> <th scope="row">允许的内容</th> <td> <a href="/zh-CN/docs/Web/HTML/Guides/Content_categories#流式内容" >流式内容</a >,但没有 <code><header></code> 或 footer 后代。 </td> </tr> <tr> <th scope="row">标签省略</th> <td>不允许,开始标签和结束标签都不能省略。</td> </tr> <tr> <th scope="row">允许的父元素</th> <td> 任何接受<a href="/zh-CN/docs/Web/HTML/Guides/Content_categories#flow_content" >流式内容</a >的元素。请注意,<code><header></code> 元素不得是 address、footer 或另一个 <code><header></code> 元素的后代。 </td> </tr> <tr> <th scope="row">隐含的 ARIA 角色</th> <td> 如果是 <code><a href="/zh-CN/docs/Web/HTML/Reference/Elements/article">article</a></code >、<code><a href="/zh-CN/docs/Web/HTML/Reference/Elements/aside">aside</a></code >、<code><a href="/zh-CN/docs/Web/HTML/Reference/Elements/main">main</a></code >、<code><a href="/zh-CN/docs/Web/HTML/Reference/Elements/nav">nav</a></code> 或是 <code><a href="/zh-CN/docs/Web/HTML/Reference/Elements/section">section</a></code> 元素的后代,或者是带有 <code >role=<a href="/zh-CN/docs/Web/Accessibility/ARIA/Reference/Roles/article_role" >article</a ></code >、<code ><a href="/zh-CN/docs/Web/Accessibility/ARIA/Reference/Roles/complementary_role" >complementary</a ></code >、<code ><a href="/zh-CN/docs/Web/Accessibility/ARIA/Reference/Roles/main_role" >main</a ></code >、<code ><a href="/zh-CN/docs/Web/Accessibility/ARIA/Reference/Roles/navigation_role" >navigation</a ></code > 或 <code ><a href="/zh-CN/docs/Web/Accessibility/ARIA/Reference/Roles/region_role" >region</a ></code > 属性的元素的后代,则为 <a href="/zh-CN/docs/Web/Accessibility/ARIA/Reference/Roles/generic_role">generic</a>;否则为 <a href="/zh-CN/docs/Web/Accessibility/ARIA/Reference/Roles/banner_role">banner</a>。 </td> </tr> <tr> <th scope="row">允许的 ARIA 角色</th> <td> <a href="/zh-CN/docs/Web/Accessibility/ARIA/Reference/Roles/group_role"><code>group</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/none_role"><code>none</code></a> </td> </tr> <tr> <th scope="row">DOM 接口</th> <td>HTMLElement</td> </tr> </tbody> </table>

规范

浏览器兼容性

参见

  • 其他与章节相关的元素:body、nav、article、aside、Heading_Elements、Heading_Elements、Heading_Elements、Heading_Elements、Heading_Elements、Heading_Elements、footer、section、address。

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。