Přejít k obsahu

Média

Obrázky motivu nejsou v knihovně médií, takže WordPress nezná jejich rozměry a každý obrázek bez stylů při načítání posouvá rozložení stránky. Blockstudio tento problém řeší generovaným manifestem metadat, pomocnou funkcí šablony, která vždy vypíše skutečné rozměry, a volitelným líným načítáním.

Vykreslování obrázků

bs_media_image() vykresluje prostředky motivu se skutečnou šířkou, výškou a vyhrazeným poměrem stran:

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ýstupem je figure.blockstudio-media s vloženým aspect-ratio kolem img, které obsahuje skutečné hodnoty width, height, loading a decoding.

src přijímá cestu relativní k motivu, absolutní cestu nebo úplnou adresu URL; attachmentId slouží pro obrázky z knihovny médií. eager vypíná líné načítání nad přehybem stránky a sources vytvoří prvek <picture> se zadanými alternativami.

Pokud existují metadata, pomocná funkce vždy vypíše známé hodnoty šířky, výšky a poměru stran. Režim líného načítání používá pouze třídy, atributy, handly a globální proměnné blockstudio-*.

Manifest metadat

Rozměry pocházejí z assets/media.json, který vytvoří Blockstudio\Media_Metadata_Builder během kroku sestavení nebo ručně:

PHP
use Blockstudio\Media_Metadata_Builder;

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

Tím se zapíší deterministická metadata prostředků motivu a při použití druhého argumentu také volitelných příloh WordPress. Manifest znovu vygenerujte při každé změně souborů v assets/.

Media_Metadata_Builder::build( string $root ) vrátí manifest bez zápisu; varianta write() jej uloží. Blockstudio\Media_Metadata::reset() po sestavení vymaže mezipaměť procesu, což je potřeba v dlouho běžících procesech sestavení před vykreslováním s aktuálními metadaty.

Líné načítání

Nastavení performance.media řídí načítání na frontendu:

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

Je-li povoleno lazy, skutečné URL se přesune do data-src za správně velký zástupný prvek a načítač Blockstudio založený na průniku jej zobrazí, když se obrázek blíží k výřezu stránky; rootMargin načte obrázek předem. skeleton zobrazí vestavěný zástupný prvek načítání a metadata deklaruje použití assets/media.json.

Profily výkonu speed a strict povolují načítač ve výchozím nastavení; profil compat jej ponechává vypnutý. Každá podřízená hodnota může přepsat výchozí nastavení profilu.

Nastavení

Úplná tabulka možností performance.media.

Statické předběžné vykreslování

Metadata médií jsou druhým krokem v pořadí zavádění do produkce.