Média
A témaképek a médiatártól külön helyen találhatók, ezért a WordPress nem ismeri a méreteiket, és minden formázatlan kép elmozdítja az elrendezést betöltés közben. A Blockstudio egy létrehozott metaadatjegyzékkel, egy sablonsúgóval, amely mindig valódi méreteket jelenít meg, valamint egy opcionális lusta betöltővel pótolja ezt a hiányosságot.
Képek renderelése
A bs_media_image() a témaeszközöket a valós szélesség és magasság megadásával, valamint egy fenntartott képaránnyal jeleníti meg:
<?php
echo bs_media_image([
'src' => 'assets/images/hero.webp',
'alt' => 'Hero',
'class' => 'hero-media',
'sources' => [
['srcset' => '/hero-small.webp', 'media' => '(max-width: 640px)'],
],
]);
?>
A kimenet egy figure.blockstudio-media inline aspect-ratio elemmel egy olyan img körül, amely valós width, height, loading és decoding értékeket tartalmaz.
A src téma szerinti relatív útvonalat, abszolút útvonalat vagy teljes URL értéket fogad el, a attachmentId pedig a médiatár képeit kezeli. A eager kikapcsolja a lusta betöltést a hajtás feletti tartalomnál, a sources pedig <picture> elemet hoz létre a megadott alternatívákkal.
Ha rendelkezésre állnak metaadatok, a súgó mindig megjeleníti az ismert szélesség-, magasság- és képarányértékeket. A lusta mód kizárólag blockstudio-* osztályokat, attribútumokat, kezelőket és globális változókat használ.
A metaadatjegyzék
A méretek forrása a assets/media.json, amelyet a Blockstudio\Media_Metadata_Builder ír meg egy összeállítási lépésben vagy kézzel:
use Blockstudio\Media_Metadata_Builder;
(new Media_Metadata_Builder())->write(
get_stylesheet_directory(),
true
);
Ez determinisztikus metaadatokat ír a téma eszközeihez, a második argumentummal pedig opcionális WordPress mellékletekhez. A assets/ alatti fájlok módosításakor hozza létre újra.
A Media_Metadata_Builder::build( string $root ) a jegyzéket visszaadja anélkül, hogy kiírná; a write() változat menti is.
A Blockstudio\Media_Metadata::reset() újraépítés után törli a folyamaton belüli gyorsítótárat; a hosszú élettartamú összeállítási folyamatoknak erre szükségük van, mielőtt az új metaadatokkal renderelnének.
Lusta betöltés
A performance.media beállításai vezérlik a front-end betöltőt:
{
"performance": {
"media": {
"lazy": true,
"skeleton": true,
"metadata": true,
"rootMargin": "300px"
}
}
}
Ha a lazy be van kapcsolva, a valódi URL átkerül a data-src értékbe egy megfelelő méretű helyőrző mögé, majd a Blockstudio metszetalapú betöltője lecseréli, amikor a kép megközelíti a nézetablakot. A rootMargin előre betölti. A skeleton megjeleníti a beépített betöltési helyőrzőt, a metadata pedig jelzi, hogy használatban van a assets/media.json.
Az speed és a strict teljesítményprofil alapértelmezés szerint engedélyezi a betöltőt; az compat kikapcsolva hagyja. Minden gyermekérték felülírhatja a profil alapértelmezését.
A teljes
performance.mediabeállítástáblázat.
Az éles környezetre való átállás sorrendjében a média-metaadat a második lépés.