Liigu sisu juurde

Meedia

Teema pildid asuvad meediateegist väljaspool, seega WordPress ei tea nende mõõtmeid ja iga stiilita pilt nihutab laadimise ajal paigutust. Blockstudio lahendab selle probleemi genereeritud metaandmete manifesti, malliabiga, mis väljastab alati tegelikud mõõtmed, ja valikulise laiska laadimisega.

Piltide renderdamine

bs_media_image() renderdab teema varad tegeliku laiuse ja kõrgusega ning reserveerib nende kuvasuhte:

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

Väljund on figure.blockstudio-media, mille ümber on reasiseselt aspect-ratio ning mille sees on img tegelike väärtustega width, height, loading ja decoding.

src võtab teema suhtelise tee, absoluutse tee või täieliku URL; meediateegi pilte käsitleb attachmentId. eager lülitab laiska laadimise välja kuva ülaosas ja sources väljastab elemendi <picture> etteantud alternatiividega.

Kui metaandmed on olemas, väljastab abifunktsioon alati teadaolevad laiuse, kõrguse ja kuvasuhte väärtused. Laisk laadimisrežiim kasutab ainult blockstudio-* klasse, atribuute, haldureid ja globaalseid muutujaid.

Metaandmete manifest

Mõõtmed pärinevad allikast assets/media.json, mille kirjutab ehitusetapis Blockstudio\Media_Metadata_Builder või mille saab luua käsitsi:

PHP
use Blockstudio\Media_Metadata_Builder;

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

See kirjutab teema varade kohta deterministlikud metaandmed ja teise argumendi korral ka valikulised WordPress manused. Genereeri see uuesti alati, kui kataloogi assets/ faile muudetakse.

Media_Metadata_Builder::build( string $root ) tagastab manifesti seda kirjutamata; write() on variant, mis salvestab selle püsivalt. Blockstudio\Media_Metadata::reset() tühjendab protsessisisese vahemälu pärast uut koostamist; pika elueaga koostamisprotsessid peavad seda tegema enne värskete metaandmete põhjal renderdamist.

Laisk laadimine

Esilaaduri tööd juhivad sätted performance.media:

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

Kui lazy on sisse lülitatud, teisaldatakse tegelik URL väärtusele data-src ning selle asemele jääb õigete mõõtmetega kohatäitja. Blockstudio lõikumispõhine laadur asendab kohatäitja pildiga, kui see vaateaknasse jõuab, ja laeb rootMargin ette. skeleton kuvab sisseehitatud laadimiskohatäitja ning metadata määrab, et kasutusel on assets/media.json.

Jõudlusprofiilid speed ja strict lubavad laaduri vaikimisi sisse; compat jätab selle välja. Iga alamelement võib profiili vaikeväärtuse üle kirjutada.

Sätted

Kõikide suvandite tabel performance.media.

Staatiline eelrenderdamine

Meedia metaandmed on tootmiskasutusele ülemineku järjekorras teine etapp.