Media
Teemakuvat sijaitsevat mediakirjaston ulkopuolella, joten WordPress ei tiedä niiden mittoja ja tyylitön kuva siirtää aina sivun asettelua latautuessaan. Blockstudio korjaa tämän luomalla metatietomanifestin, tarjoamalla sivupohja-apufunktion, joka tulostaa aina todelliset mitat, sekä valinnaisen laiskan latauksen.
Kuvien renderöinti
bs_media_image() renderöi teeman resurssit oikeilla leveys- ja korkeusarvoilla ja varatulla kuvasuhteella:
<?php
echo bs_media_image([
'src' => 'assets/images/hero.webp',
'alt' => 'Hero',
'class' => 'hero-media',
'sources' => [
['srcset' => '/hero-small.webp', 'media' => '(max-width: 640px)'],
],
]);
?>
Tulosteena on figure.blockstudio-media, jonka img-elementin ympärillä on upotettu aspect-ratio. Elementissä on oikeat arvot: width, height, loading ja decoding.
src hyväksyy teemaan suhteutetun polun, absoluuttisen polun tai täydellisen URL-osoitteen, ja attachmentId käsittelee mediakirjaston kuvat. eager poistaa laiskan latauksen käytöstä alkusivulla, ja sources tulostaa <picture>-elementin annettuine vaihtoehtoineen.
Apufunktio tulostaa aina tunnetut leveys-, korkeus- ja kuvasuhdearvot, kun metatietoja on saatavilla. Lataustila käyttää vain blockstudio-*-luokkia, -attribuutteja, -käsittelijöitä ja -yleismuuttujia.
Metatietomanifesti
Mitat haetaan kohteesta assets/media.json, jonka Blockstudio\Media_Metadata_Builder kirjoittaa koontivaiheessa tai käsin:
use Blockstudio\Media_Metadata_Builder;
(new Media_Metadata_Builder())->write(
get_stylesheet_directory(),
true
);
Tämä kirjoittaa deterministiset metatiedot teeman resursseille ja toisella argumentilla valinnaisille WordPress-liitteille. Luo tiedosto uudelleen aina, kun hakemiston assets/ tiedostot muuttuvat.
Media_Metadata_Builder::build( string $root ) palauttaa manifestin tallentamatta sitä; write() tallentaa sen. Blockstudio\Media_Metadata::reset() tyhjentää prosessikohtaisen välimuistin koontiversion luonnin jälkeen. Pitkäikäiset koontiprosessit tarvitsevat tämän, jotta ne renderöivät uusien metatietojen mukaan.
Laiska lataus
Asetukset performance.media ohjaavat käyttöliittymän lataajaa:
{
"performance": {
"media": {
"lazy": true,
"skeleton": true,
"metadata": true,
"rootMargin": "300px"
}
}
}
Kun lazy on käytössä, varsinainen URL siirretään kohteeseen data-src oikeankokoisen paikkamerkin taakse. Kohteen Blockstudio leikkauspisteeseen perustuva lataaja tuo sen näkyviin kuvan lähestyessä näkymäaluetta ja rootMargin lataa sen ennakkoon. skeleton näyttää sisäänrakennetun latauksen paikkamerkin, ja metadata ilmoittaa, että assets/media.json on käytössä.
Suorituskykyprofiilit speed ja strict ottavat lataajan oletusarvoisesti käyttöön; compat jättää sen pois käytöstä. Jokainen lapsiarvo voi ohittaa profiilinsa oletusarvon.
Koko
performance.media-valintataulukko.
Median metatiedot ovat tuotantokäyttöönoton järjestyksessä toinen vaihe.