Média
Obrázky motivu nejsou v knihovně médií, takže WordPress nezná jejich rozměry a každý obrázek bez stylů při načítání posouvá rozložení stránky. Blockstudio tento problém řeší generovaným manifestem metadat, pomocnou funkcí šablony, která vždy vypíše skutečné rozměry, a volitelným líným načítáním.
Vykreslování obrázků
bs_media_image() vykresluje prostředky motivu se skutečnou šířkou, výškou a vyhrazeným poměrem stran:
<?php
echo bs_media_image([
'src' => 'assets/images/hero.webp',
'alt' => 'Hero',
'class' => 'hero-media',
'sources' => [
['srcset' => '/hero-small.webp', 'media' => '(max-width: 640px)'],
],
]);
?>
Výstupem je figure.blockstudio-media s vloženým aspect-ratio kolem img, které obsahuje skutečné hodnoty width, height, loading a decoding.
src přijímá cestu relativní k motivu, absolutní cestu nebo úplnou adresu URL; attachmentId slouží pro obrázky z knihovny médií. eager vypíná líné načítání nad přehybem stránky a sources vytvoří prvek <picture> se zadanými alternativami.
Pokud existují metadata, pomocná funkce vždy vypíše známé hodnoty šířky, výšky a poměru stran. Režim líného načítání používá pouze třídy, atributy, handly a globální proměnné blockstudio-*.
Manifest metadat
Rozměry pocházejí z assets/media.json, který vytvoří Blockstudio\Media_Metadata_Builder během kroku sestavení nebo ručně:
use Blockstudio\Media_Metadata_Builder;
(new Media_Metadata_Builder())->write(
get_stylesheet_directory(),
true
);
Tím se zapíší deterministická metadata prostředků motivu a při použití druhého argumentu také volitelných příloh WordPress. Manifest znovu vygenerujte při každé změně souborů v assets/.
Media_Metadata_Builder::build( string $root ) vrátí manifest bez zápisu; varianta write() jej uloží. Blockstudio\Media_Metadata::reset() po sestavení vymaže mezipaměť procesu, což je potřeba v dlouho běžících procesech sestavení před vykreslováním s aktuálními metadaty.
Líné načítání
Nastavení performance.media řídí načítání na frontendu:
{
"performance": {
"media": {
"lazy": true,
"skeleton": true,
"metadata": true,
"rootMargin": "300px"
}
}
}
Je-li povoleno lazy, skutečné URL se přesune do data-src za správně velký zástupný prvek a načítač Blockstudio založený na průniku jej zobrazí, když se obrázek blíží k výřezu stránky; rootMargin načte obrázek předem. skeleton zobrazí vestavěný zástupný prvek načítání a metadata deklaruje použití assets/media.json.
Profily výkonu speed a strict povolují načítač ve výchozím nastavení; profil compat jej ponechává vypnutý. Každá podřízená hodnota může přepsat výchozí nastavení profilu.
Úplná tabulka možností
performance.media.
Statické předběžné vykreslování
Metadata médií jsou druhým krokem v pořadí zavádění do produkce.