Médias
Les images du thème se trouvent en dehors de la médiathèque, donc WordPress ne connaît pas leurs dimensions et chaque image sans style déplace la mise en page pendant son chargement. Blockstudio comble cette lacune grâce à un manifeste de métadonnées généré, un assistant de modèle qui émet toujours les dimensions réelles et un chargeur différé facultatif.
Rendu des images
bs_media_image() affiche les ressources du thème avec leur largeur et hauteur réelles et un rapport hauteur/largeur réservé :
<?php
echo bs_media_image([
'src' => 'assets/images/hero.webp',
'alt' => 'Hero',
'class' => 'hero-media',
'sources' => [
['srcset' => '/hero-small.webp', 'media' => '(max-width: 640px)'],
],
]);
?>
La sortie est un figure.blockstudio-media avec un élément aspect-ratio en ligne autour d’un img contenant les valeurs réelles de width, height, loading et decoding.
src accepte un chemin relatif au thème, un chemin absolu ou une adresse URL complète, et attachmentId prend en charge les images de la médiathèque. eager désactive le chargement différé au-dessus de la ligne de flottaison, et sources émet un élément <picture> avec les variantes indiquées.
Lorsque des métadonnées existent, l’assistant émet toujours les valeurs connues de largeur, de hauteur et de rapport hauteur/largeur. Le mode différé utilise uniquement les classes, attributs, gestionnaires et variables globales blockstudio-*.
Manifeste des métadonnées
Les dimensions proviennent de assets/media.json, écrit par Blockstudio\Media_Metadata_Builder lors d’une étape de build ou manuellement :
use Blockstudio\Media_Metadata_Builder;
(new Media_Metadata_Builder())->write(
get_stylesheet_directory(),
true
);
Cela écrit des métadonnées déterministes pour les ressources du thème et, avec le second argument, pour les pièces jointes facultatives WordPress. Régénérez-les chaque fois que des fichiers de assets/ sont modifiés.
Media_Metadata_Builder::build( string $root ) renvoie le manifeste sans l’écrire ; write() est la variante qui le conserve. Blockstudio\Media_Metadata::reset() vide le cache en processus après une reconstruction, ce que les processus de build de longue durée doivent faire avant le rendu avec les métadonnées actualisées.
Chargement différé
Les réglages performance.media pilotent le chargeur frontend :
{
"performance": {
"media": {
"lazy": true,
"skeleton": true,
"metadata": true,
"rootMargin": "300px"
}
}
}
Lorsque lazy est activé, le véritable URL est déplacé vers data-src derrière un espace réservé aux dimensions correctes. Le chargeur de Blockstudio, fondé sur l’intersection, le remplace à l’approche de la fenêtre d’affichage ; rootMargin est chargé à l’avance. skeleton affiche l’espace réservé de chargement intégré, et metadata indique que assets/media.json est utilisé.
Les profils de performance speed et strict activent le chargeur par défaut ; compat le laisse désactivé. Chaque valeur enfant peut remplacer la valeur par défaut de son profil.
Le tableau complet des options
performance.media.
Les métadonnées des médias constituent la deuxième étape de l’ordre d’adoption en production.