Preskoči na vsebino

Predstavnost

Slike tem so zunaj knjižnice predstavnosti, zato WordPress ne pozna njihovih dimenzij in vsaka neoblikovana slika med nalaganjem premakne postavitev. Blockstudio to težavo odpravi z ustvarjenim manifestom metapodatkov, pomočnikom predloge, ki vedno izpiše dejanske dimenzije, in izbirnim nalagalnikom za leno nalaganje.

Izrisovanje slik

bs_media_image() izriše sredstva teme z dejansko širino, višino in rezerviranim razmerjem stranic:

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)'],
    ],
]);
?>

Izhod je figure.blockstudio-media z vstavljenim aspect-ratio okoli elementa img, ki vsebuje dejanske vrednosti width, height, loading in decoding.

src sprejme pot glede na temo, absolutno pot ali celoten URL, medtem ko attachmentId pokriva slike iz knjižnice predstavnosti. eager izključi leno nalaganje za vsebino nad pregibom, sources pa izpiše element <picture> z danimi nadomestnimi možnostmi.

Če obstajajo metapodatki, pomočnik vedno izpiše znane vrednosti širine, višine in razmerja stranic. Način lenega nalaganja uporablja samo razrede, atribute, ročice in globalne spremenljivke blockstudio-*.

Manifest metapodatkov

Dimenzije izvirajo iz assets/media.json, ki ga v koraku gradnje zapiše Blockstudio\Media_Metadata_Builder ali ga ustvarite ročno:

PHP
use Blockstudio\Media_Metadata_Builder;

(new Media_Metadata_Builder())->write(
    get_stylesheet_directory(),
    true
);

To zapiše deterministične metapodatke za sredstva teme in z drugim argumentom tudi izbirne priloge WordPress. Ponovno jih ustvarite vsakič, ko se spremenijo datoteke v assets/.

Media_Metadata_Builder::build( string $root ) vrne manifest, ne da bi ga zapisal; write() je različica, ki ga shrani. Blockstudio\Media_Metadata::reset() po vnovični gradnji počisti predpomnilnik procesa, kar morajo storiti dolgotrajni procesi gradnje, preden izrisujejo s svežimi metapodatki.

Leno nalaganje

Nastavitve performance.media usmerjajo nalagalnik v uporabniškem delu:

JSON
{
  "performance": {
    "media": {
      "lazy": true,
      "skeleton": true,
      "metadata": true,
      "rootMargin": "300px"
    }
  }
}

Ko je omogočeno lazy, se dejanska URL premakne v data-src za pravilno dimenzioniranim nadomestnim elementom, nalagalnik Blockstudio, ki temelji na presečišču, pa jo vstavi, ko se slika približuje vidnemu polju, rootMargin vnaprej. skeleton prikaže vgrajeni nadomestni element za nalaganje, metadata pa pove, da je v uporabi assets/media.json.

Profila speed in strict profilov učinkovitosti privzeto omogočita nalagalnik; compat ga pusti izklopljenega. Vsaka podrejena vrednost lahko preglasi privzeto vrednost profila.

Nastavitve

Celotna preglednica možnosti performance.media.

Statično vnaprejšnje izrisovanje

Metapodatki predstavnosti so drugi korak v vrstnem redu uvedbe za produkcijo.