Siirry sisältöön

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

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

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

Asetukset

Koko performance.media-valintataulukko.

Staattinen esirenderöinti

Median metatiedot ovat tuotantokäyttöönoton järjestyksessä toinen vaihe.