Ugrás a tartalomhoz

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
<?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:

PHP
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:

JSON
{
  "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.

Beállítások

A teljes performance.media beállítástáblázat.

Statikus előrenderelés

Az éles környezetre való átállás sorrendjében a média-metaadat a második lépés.