Hoppa till innehåll

Media

Temabilder finns utanför mediebiblioteket, så WordPress känner inte till deras mått och varje bild utan formatmallar förskjuter layouten medan den läses in. Blockstudio åtgärdar detta med ett genererat metadatamanifest, en mallhjälpare som alltid anger de faktiska måtten och en valfri lazy loader.

Bildrendering

bs_media_image() renderar temats resurser med faktiska värden för bredd och höjd samt ett reserverat bildförhållande:

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

Utdata är ett figure.blockstudio-media med en infogad aspect-ratio runt ett img som har faktiska värden för width, height, loading och decoding.

src tar en temarelativ sökväg, en absolut sökväg eller en fullständig URL, och attachmentId omfattar bilder från mediebiblioteket. eager väljer bort lazy loading ovanför vecket, och sources skapar ett element av typen <picture> med angivna alternativa källor.

Hjälparen anger alltid kända värden för bredd, höjd och bildförhållande när metadata finns. Läget för lazy loading använder endast blockstudio-*-klasser, attribut, handtag och globala variabler.

Metadatamanifestet

Måtten hämtas från assets/media.json, som skrivs av Blockstudio\Media_Metadata_Builder under ett byggsteg eller manuellt:

PHP
use Blockstudio\Media_Metadata_Builder;

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

Detta skriver deterministiska metadata för temats resurser och, med det andra argumentet, valfria WordPress-bilagor. Skapa om manifestet när filer under assets/ ändras.

Media_Metadata_Builder::build( string $root ) returnerar manifestet utan att skriva det; write() är varianten som sparar det. Blockstudio\Media_Metadata::reset() tömmer cachen i processen efter en ombyggnad, vilket långlivade byggprocesser behöver innan de renderar med uppdaterade metadata.

Lazy loading

Inställningarna för performance.media styr frontendens loader:

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

När lazy är aktiverat flyttas det faktiska URL till data-src bakom en platshållare med rätt mått. Den skärningsbaserade loadern i Blockstudio byter ut den när bilden närmar sig visningsområdet, och rootMargin gör att bilden läses in i förväg. skeleton visar den inbyggda laddningsplatshållaren, och metadata anger att assets/media.json används.

Profilerna för speed och strict prestanda aktiverar loadern som standard; compat lämnar den inaktiverad. Varje underordnat värde kan åsidosätta profilens standardvärde.

Inställningar

Den fullständiga tabellen över alternativen performance.media.

Statisk förhandsrendering

Mediametadata är steg två i produktionsordningen för införande.