parts/header.html

Définition : Le fichier parts/header.html définit généralement l’en-tête réutilisable d’un thème de blocs WordPress. Il contient du balisage de blocs et peut être appelé depuis plusieurs templates par un bloc Template Part.

Terminologie

Nom technique : parts/header.html

Appellations : Nom principal utilisé

À quoi cela sert, concrètement

Il centralise les éléments de reconnaissance et de navigation : logo, titre du site ou liens. Un seul emplacement de maintenance réduit les incohérences entre les différentes pages.

Fonctionnement détaillé

Lorsqu’un template référence le slug header, WordPress recherche la partie correspondante et interprète son balisage de blocs. Le dossier recommandé s’appelle parts et la partie peut avoir un nom et une zone déclarés dans theme.json.

Quand l’utiliser : contexte et choix techniques

Prévoir ce fichier dans un thème de blocs qui partage son en-tête entre plusieurs modèles. Utiliser les blocs Site Title, Site Logo et Navigation plutôt que du HTML statique lorsqu’ils répondent au besoin.

Situation professionnelle réaliste

Le même en-tête apparaît au-dessus des articles, pages fixes et archives d’une encyclopédie technique.

Exemple pratique — HTML / balisage de blocs

Exemple pédagogique : adapter le nom du thème, les fichiers et les conditions à un environnement de développement. Il ne constitue pas une preuve d’exécution sur ATOOLPHA.

<!-- Fichier parts/header.html -->
<!-- wp:group {"tagName":"header","layout":{"type":"constrained"}} -->
<header class="wp-block-group">
  <!-- wp:site-title /-->
  <!-- wp:site-tagline /-->
</header>
<!-- /wp:group -->

Décryptage de l’exemple, étape par étape

Le Groupe utilise l’élément HTML header et contient deux blocs dynamiques : le titre et la description du site. Le template principal doit inclure la partie par son slug, sinon ce fichier n’est pas affiché automatiquement.

Résultat observable

Quand la partie est référencée, l’en-tête reprend les informations de l’installation WordPress. Il n’ajoute pas de menu de navigation dans cet exemple minimal.

Exercice de vérification pratique

Créer le fichier dans un thème à blocs de développement, puis insérer un bloc Template Part dans templates/index.html. Vérifier que l’en-tête s’affiche sur plusieurs types de contenu.

Pièges, limites et sécurité

L’éditeur de site peut sauvegarder une version personnalisée prioritaire sur le fichier. Vérifier la cohérence sémantique : un seul en-tête principal, navigation accessible et contrastes suffisants.

Différences avec les notions voisines

parts/header.html est une partie de thème de blocs ; header.php est le modèle d’en-tête courant d’un thème classique.

Diagnostic avancé et cas de maintenance

Cas avancé : un en-tête commun comporte une navigation mal accessible. Corriger simplement la partie réutilisable peut suffire à améliorer tous les templates qui la chargent. Tester la cohérence des titres, le focus clavier et les régions header/nav, en vérifiant les versions personnalisées en base.