`<header>` HTML header element

فهرست فصل‌ها دانلود آرشیوناشر

MDN Web Docs · نسخهٔ df622a2a1c1e · CC BY-SA 2.5 و مجوز جداگانهٔ ناشر برای نمونه‌کد

The **<header>** HTML element represents introductory content, typically a group of introductory or navigational aids. It may contain some heading elements but also a logo, a search form, an author name, and other elements.

{{InteractiveExample("HTML Demo: &lt;header&gt;", "tabbed-standard")}}

html interactive-example
<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>
css interactive-example
.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: black 2px 2px 0.2rem;
}

header > h1 {
  margin-bottom: 0;
}

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

Attributes

This element only includes the global attributes.

Usage notes

When not nested within sectioning content, {{htmlelement("main")}}, or an element with the same ARIA role as these elements' implicit ARIA role, then the <header> element has an identical meaning to the site-wide [banner](/en-US/docs/Web/Accessibility/ARIA/Reference/Roles/banner_role) landmark role. It defines a global site header, which usually includes a logo, company name, search feature, and possibly the global navigation or a slogan. It is generally located at the top of the page.

Otherwise, when nested within said elements, it loses its landmark status and represents a group of introductory or navigational aids for the surrounding section. It usually contains the surrounding section's heading (an h1 – h6 element) and optional subheading, but this is not required.

Historical Usage

The <header> element originally existed at the very beginning of HTML for headings. It is seen in the very first website. At some point, headings became [<h1> through <h6>](/en-US/docs/Web/HTML/Reference/Elements/Heading_Elements), allowing <header> to be free to fill a different role.

Accessibility

The <header> element defines a [banner](/en-US/docs/Web/Accessibility/ARIA/Reference/Roles/banner_role) landmark when its context is the {{HTMLElement('body')}} element.

When placed inside an {{HTMLElement('article')}}, {{HTMLElement('main')}}, {{HTMLElement('section')}}, {{HTMLElement('nav')}}, {{HTMLElement('aside')}}, or an element with the same ARIA role as these elements' implicit ARIA role, the <header> element has the [generic](/en-US/docs/Web/Accessibility/ARIA/Reference/Roles/generic_role) role instead, and is no longer considered a landmark. In this case, it cannot be labeled with [aria-label](/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-label) or [aria-labelledby](/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-labelledby).

Examples

Page Header

html
<header>
  <h1>Main Page Title</h1>
  <img src="mdn-logo-sm.png" alt="MDN logo" />
</header>

Result

{{EmbedLiveSample('Page Header')}}

Article Header

html
<article>
  <header>
    <h2>The Planet Earth</h2>
    <p>
      Posted on Wednesday, <time datetime="2017-10-04">4 October 2017</time> by
      Jane Smith
    </p>
  </header>
  <p>
    We live on a planet that's blue and green, with so many things still unseen.
  </p>
  <p><a href="https://example.com/the-planet-earth/">Continue reading…</a></p>
</article>

Result

{{EmbedLiveSample('Article Header')}}

Technical summary

<table class="properties"> <tbody> <tr> <th scope="row"> <a href="/en-US/docs/Web/HTML/Guides/Content_categories"

توجه: Content categories</a

</th> <td> <a href="/en-US/docs/Web/HTML/Guides/Content_categories#flow_content"

توجه: Flow content</a ,

<a href="/en-US/docs/Web/HTML/Guides/Content_categories#palpable_content"

توجه: palpable content</a .

</td> </tr> <tr> <th scope="row">Permitted content</th> <td> <a href="/en-US/docs/Web/HTML/Guides/Content_categories#flow_content"

توجه: Flow content</a , but with no <code>&#x3C;header></code> or

{{HTMLElement("footer")}} descendant. </td> </tr> <tr> <th scope="row">Tag omission</th> <td>None, both the starting and ending tag are mandatory.</td> </tr> <tr> <th scope="row">Permitted parents</th> <td> Any element that accepts <a href="/en-US/docs/Web/HTML/Guides/Content_categories#flow_content"

توجه: flow content</a . Note that a <code>&#x3C;header></code> element must not be a

descendant of an {{HTMLElement("address")}}, {{HTMLElement("footer")}} or another <code>&lt;header&gt;</code> element. </td> </tr> <tr> <th scope="row">Implicit ARIA role</th> <td> <a href="/en-US/docs/Web/Accessibility/ARIA/Reference/Roles/banner_role">banner</a

توجه: , or

<a href="/en-US/docs/Web/Accessibility/ARIA/Reference/Roles/generic_role"

توجه: generic</a

if a descendant of an <code><a href="/en-US/docs/Web/HTML/Reference/Elements/article">article</a></code

توجه: , <code><a href="/en-US/docs/Web/HTML/Reference/Elements/aside">aside</a></code , <code><a href="/en-US/docs/Web/HTML/Reference/Elements/main">main</a></code , <code><a href="/en-US/docs/Web/HTML/Reference/Elements/nav">nav</a></code> or

<code><a href="/en-US/docs/Web/HTML/Reference/Elements/section">section</a></code> element, or an element with <code

توجه: <a href="/en-US/docs/Web/Accessibility/ARIA/Reference/Roles/article_role" article</a </code ,

<code

توجه: <a href="/en-US/docs/Web/Accessibility/ARIA/Reference/Roles/complementary_role" complementary</a </code ,

<code

توجه: <a href="/en-US/docs/Web/Accessibility/ARIA/Reference/Roles/main_role" main</a </code ,

<code

توجه: <a href="/en-US/docs/Web/Accessibility/ARIA/Reference/Roles/navigation_role" navigation</a </code

or <code

توجه: <a href="/en-US/docs/Web/Accessibility/ARIA/Reference/Roles/region_role" region</a </code role

</td> </tr> <tr> <th scope="row">Permitted ARIA roles</th> <td> <a href="/en-US/docs/Web/Accessibility/ARIA/Reference/Roles/group_role"><code>group</code></a>, <a href="/en-US/docs/Web/Accessibility/ARIA/Reference/Roles/presentation_role"><code>presentation</code></a> or <a href="/en-US/docs/Web/Accessibility/ARIA/Reference/Roles/none_role"><code>none</code></a> </td> </tr> <tr> <th scope="row">DOM interface</th> <td>{{domxref("HTMLElement")}}</td> </tr> </tbody> </table>

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}

See also

  • Other section-related elements: {{HTMLElement("body")}}, {{HTMLElement("nav")}}, {{HTMLElement("article")}}, {{HTMLElement("aside")}}, {{HTMLElement("Heading_Elements", "h1")}}, {{HTMLElement("Heading_Elements", "h2")}}, {{HTMLElement("Heading_Elements", "h3")}}, {{HTMLElement("Heading_Elements", "h4")}}, {{HTMLElement("Heading_Elements", "h5")}}, {{HTMLElement("Heading_Elements", "h6")}}, {{HTMLElement("footer")}}, {{HTMLElement("section")}}, {{HTMLElement("address")}}.