Medija
Temos vaizdai laikomi už medijos bibliotekos ribų, todėl WordPress nežino jų matmenų, o kiekvienas stilių neturintis vaizdas jį įkeliant išstumia puslapio turinį. Blockstudio išsprendžia šią problemą sugeneruotu metaduomenų aprašo failu, šablonų pagalbine funkcija, kuri visada pateikia tikruosius matmenis, ir pasirinktiniu tingiojo įkėlimo įrankiu.
Vaizdų atvaizdavimas
bs_media_image() atvaizduoja temos išteklius su tikrais pločio ir aukščio matmenimis bei rezervuotu kraštinių santykiu:
<?php
echo bs_media_image([
'src' => 'assets/images/hero.webp',
'alt' => 'Hero',
'class' => 'hero-media',
'sources' => [
['srcset' => '/hero-small.webp', 'media' => '(max-width: 640px)'],
],
]);
?>
Išvestyje yra figure.blockstudio-media su įterptiniu aspect-ratio aplink img, kuriam priskirtos tikrosios width, height, loading ir decoding reikšmės.
src priima su tema susietą santykinį kelią, absoliutų kelią arba visą URL, o attachmentId naudojamas medijos bibliotekos vaizdams. eager išjungia tingųjį įkėlimą srityje, matomoje be slinkimo, o sources pateikia <picture> elementą su nurodytais alternatyviais ištekliais.
Jei yra metaduomenų, pagalbinė funkcija visada pateikia žinomus pločio, aukščio ir kraštinių santykio duomenis. Tingiojo įkėlimo režimas naudoja tik blockstudio-* klases, atributus, išteklių valdiklius ir globaliuosius objektus.
Metaduomenų aprašo failas
Matmenys imami iš assets/media.json, kurį kūrimo metu arba rankiniu būdu įrašo Blockstudio\Media_Metadata_Builder:
use Blockstudio\Media_Metadata_Builder;
(new Media_Metadata_Builder())->write(
get_stylesheet_directory(),
true
);
Taip įrašomi deterministiniai temos išteklių metaduomenys ir, pateikus antrąjį argumentą, pasirinktiniai WordPress priedai. Atkurkite aprašo failą kaskart pakeitę assets/ esančius failus.
Media_Metadata_Builder::build( string $root ) grąžina aprašo failą jo neįrašydama; write() yra variantas, kuris jį išsaugo. Blockstudio\Media_Metadata::reset() išvalo proceso atminties podėlį po pakartotinio kūrimo; ilgai veikiantiems kūrimo procesams to reikia, kad atvaizduojant būtų naudojami nauji metaduomenys.
Tinginysis įkėlimas
Sąsajos įkėliklio veikimą valdo performance.media nustatymai:
{
"performance": {
"media": {
"lazy": true,
"skeleton": true,
"metadata": true,
"rootMargin": "300px"
}
}
}
Įjungus lazy, tikrasis URL perkeliamas į data-src, o jo vietą užima tinkamo dydžio vietos rezervavimo elementas. Blockstudio įkėliklis, pagrįstas matomumo srities stebėjimu, pakeičia jį tikruoju vaizdu, kai vaizdas priartėja prie matymo srities; rootMargin tuo pasirūpina iš anksto. skeleton rodo įtaisytąjį įkėlimo vietos rezervavimo elementą, o metadata nurodo, kad naudojama assets/media.json.
Aplinkos speed ir strict našumo profiliuose įkėliklis įjungtas pagal numatytuosius nustatymus; compat jį palieka išjungtą. Kiekviena antrinė reikšmė gali pakeisti profilio numatytąją reikšmę.
Visa
performance.mediaparinkčių lentelė.
Statinis išankstinis atvaizdavimas
Medijos metaduomenys – antrasis gamybinės aplinkos diegimo etapas.