Preskočiť na obsah

Médiá

Obrázky témy sa nachádzajú mimo knižnice médií, preto WordPress nepozná ich rozmery a každý nenaštýlovaný obrázok počas načítavania posúva rozloženie. Blockstudio tento nedostatok odstraňuje generovaným manifestom metadát, pomocnou funkciou šablóny, ktorá vždy vypíše skutočné rozmery, a voliteľným lenivým načítavačom.

Vykresľovanie obrázkov

bs_media_image() vykresľuje zdroje témy so skutočnou šírkou, výškou a vyhradeným pomerom strán:

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ýstup tvorí figure.blockstudio-media so vloženým aspect-ratio okolo img, ktoré obsahuje skutočné hodnoty width, height, loading a decoding.

src prijíma cestu relatívnu k téme, absolútnu cestu alebo úplný URL a attachmentId pokrýva obrázky z knižnice médií. eager vypne lenivé načítavanie nad prehybom stránky a sources vytvorí prvok <picture> so zadanými alternatívami.

Ak sú metadáta k dispozícii, pomocná funkcia vždy vypíše známe hodnoty šírky, výšky a pomeru strán. Režim lenivého načítavania používa iba triedy, atribúty, obslužné prvky a globálne premenné blockstudio-*.

Manifest metadát

Rozmery pochádzajú z assets/media.json, ktorý vytvorí Blockstudio\Media_Metadata_Builder v kroku zostavenia alebo ručne:

PHP
use Blockstudio\Media_Metadata_Builder;

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

Týmto sa zapíšu deterministické metadáta prostriedkov témy a pri druhom argumente aj voliteľné prílohy WordPress. Znova ich vytvorte vždy, keď sa zmenia súbory v assets/.

Media_Metadata_Builder::build( string $root ) vráti manifest bez jeho zápisu; write() je variant, ktorý ho uloží. Blockstudio\Media_Metadata::reset() po opätovnom zostavení vymaže vyrovnávaciu pamäť v procese. Dlhodobo bežiace procesy zostavovania to potrebujú pred vykresľovaním s aktualizovanými metadátami.

Lenivé načítavanie

Nastavenia performance.media riadia načítavač frontendu:

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

Keď je zapnuté lazy, skutočné URL sa presunie na data-src za správne veľký zástupný prvok a načítavač Blockstudio založený na priesečníku ho nahradí, keď sa obrázok priblíži k výrezu, pričom rootMargin sa načíta vopred. skeleton zobrazí vstavaný zástupný prvok načítavania a metadata deklaruje, že sa používa assets/media.json.

Profily speed a strict výkonu predvolene zapínajú načítavač; compat ho necháva vypnutý. Každá podradená hodnota môže prepísať predvolenú hodnotu profilu.

Nastavenia

Úplná tabuľka možností performance.media.

Statické predbežné vykresľovanie

Metadáta médií sú druhým krokom poradia zavádzania do produkcie.