<header>
========

L'élément HTML **`<header>`** représente du contenu introductif, généralement un groupe de contenu introductif ou de contenu aidant à la navigation. Il peut contenir des éléments de titre, mais aussi d'autres éléments tels qu'un logo, un formulaire de recherche, le nom d'auteur, etc.

Exemple interactif
------------------

|  |  |
| --- | --- |
| Catégories de contenu | Contenu de flux,
 contenu tangible.
  |
| Contenu autorisé | Contenu de flux
 mais sans élément descendant qui soit `<header>` ou `<footer>`.
  |
| Omission de balises | Aucune, les balises d'ouverture et de fermeture sont obligatoires. |
| Parents autorisés | 
 Tout élément acceptant du
 contenu de flux. Il est à noter qu'un élément `<header>` ne doit pas
 descendre d'un élément `<address>`,
 `<footer>` ou d'un autre élément
 `<header>`.
  |
| Rôle ARIA implicite | `banner`, ou aucun rôle correspondant si l'élément `<header>` descend d'un élément `<article>`, `<aside>`, `<main>`, `<nav>` ou `<section>`, ou d'un élément ayant le rôle `article`, `complementary` (en-US), `main` (en-US), `navigation` (en-US) ou `region` (en-US) |
| Rôles ARIA autorisés | `group`, `presentation` ou `none` |
| Interface DOM | `HTMLElement` |

Notes d'utilisation
-------------------

L'élément `<header>` n'est pas une section de contenu et n'introduit donc pas de nouvelle section dans la structure. Cela dit, un élément `<header>` est généralement destiné à contenir l'en-tête de la section environnante (un élément `<h1>` à `<h6>`), mais ce **n'est pas** obligatoire.

### Usage historique

Bien que l'élément `<header>` ne fasse pas partie de la spécification HTML avant HTML5, il existait de façon implicite depuis les premières versions. Comme on le voit sur le premier site web, il était initialement utilisé comme l'élément `<head>`. À un moment donné, il a été décidé d'utiliser un nom différent. Cela a permis à `<header>` d'être libre de remplir un rôle différent par la suite.

Attributs
---------

Cet élément ne possède que les attributs universels.

Exemples
--------

### En-tête de page


```html
<header>
  <h1>Titre principal</h1>
  <img src="mdn-logo-sm.png" alt="Logo de MDN" />
</header>
```


#### Résultat

### En-tête d'un article


```html
<article>
  <header>
    <h2>La planète Terre</h2>
    <p>
      Publié le mercredi <time datetime="2017-10-04">4 octobre 2017</time> par
      Jeanne Smith
    </p>
  </header>
  <p>Nous vivons sur une planète bleue et verte</p>
  <p>
    <a href="https://example.com/the-planet-earth/">Poursuivre la lecture…</a>
  </p>
</article>
```


#### Résultat

Accessibilité
-------------

L'élément `<header>` définit un point de repère `banner` lorsque son contexte est un élément `<body>`. Lorsqu'un élément HTML `<header>` descend de certains éléments (tels que `<article>`, `<aside>`, `<main>`, `<nav>` ou `<section>`), il n'est pas considéré comme un repère `banner`.

Spécifications
--------------

| Specification |
| --- |
| HTML Standard # the-header-element |

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Voir aussi
----------

* Autres éléments liés à la section d'un document :
    + `<body>`
    + `<nav>`
    + `<article>`
    + `<aside>`
    + `<h1>`, `<h2>`, `<h3>`, `<h4>`, `<h5>`, `<h6>`
    + `<footer>`
    + `<section>`
    + `<address>`
* Utiliser des sections et structures HTML