Médiá
Obrázky témy sa nachádzajú mimo knižnice médií, preto WordPress nepozná ich rozmery a každý nenaštýlovaný obrázok počas načítavania posúva rozloženie. Blockstudio tento nedostatok odstraňuje generovaným manifestom metadát, pomocnou funkciou šablóny, ktorá vždy vypíše skutočné rozmery, a voliteľným lenivým načítavačom.
Vykresľovanie obrázkov
bs_media_image() vykresľuje zdroje témy so skutočnou šírkou, výškou a vyhradeným pomerom strán:
<?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ýstup tvorí figure.blockstudio-media so vloženým aspect-ratio okolo img, ktoré obsahuje skutočné hodnoty width, height, loading a decoding.
src prijíma cestu relatívnu k téme, absolútnu cestu alebo úplný URL a attachmentId pokrýva obrázky z knižnice médií. eager vypne lenivé načítavanie nad prehybom stránky a sources vytvorí prvok <picture> so zadanými alternatívami.
Ak sú metadáta k dispozícii, pomocná funkcia vždy vypíše známe hodnoty šírky, výšky a pomeru strán. Režim lenivého načítavania používa iba triedy, atribúty, obslužné prvky a globálne premenné blockstudio-*.
Manifest metadát
Rozmery pochádzajú z assets/media.json, ktorý vytvorí Blockstudio\Media_Metadata_Builder v kroku zostavenia alebo ručne:
use Blockstudio\Media_Metadata_Builder;
(new Media_Metadata_Builder())->write(
get_stylesheet_directory(),
true
);
Týmto sa zapíšu deterministické metadáta prostriedkov témy a pri druhom argumente aj voliteľné prílohy WordPress. Znova ich vytvorte vždy, keď sa zmenia súbory v assets/.
Media_Metadata_Builder::build( string $root ) vráti manifest bez jeho zápisu; write() je variant, ktorý ho uloží. Blockstudio\Media_Metadata::reset() po opätovnom zostavení vymaže vyrovnávaciu pamäť v procese. Dlhodobo bežiace procesy zostavovania to potrebujú pred vykresľovaním s aktualizovanými metadátami.
Lenivé načítavanie
Nastavenia performance.media riadia načítavač frontendu:
{
"performance": {
"media": {
"lazy": true,
"skeleton": true,
"metadata": true,
"rootMargin": "300px"
}
}
}
Keď je zapnuté lazy, skutočné URL sa presunie na data-src za správne veľký zástupný prvok a načítavač Blockstudio založený na priesečníku ho nahradí, keď sa obrázok priblíži k výrezu, pričom rootMargin sa načíta vopred. skeleton zobrazí vstavaný zástupný prvok načítavania a metadata deklaruje, že sa používa assets/media.json.
Profily speed a strict výkonu predvolene zapínajú načítavač; compat ho necháva vypnutý. Každá podradená hodnota môže prepísať predvolenú hodnotu profilu.
Úplná tabuľka možností
performance.media.
Statické predbežné vykresľovanie
Metadáta médií sú druhým krokom poradia zavádzania do produkcie.