Gå til indhold

Medier

Temabilleder ligger uden for mediebiblioteket, så WordPress kender ikke deres dimensioner, og alle ustilede billeder forskyder layoutet, mens de indlæses. Blockstudio løser det med et genereret metadatamanifest, en skabelonhjælper, der altid angiver de faktiske dimensioner, og en valgfri lazy loader.

Rendering af billeder

bs_media_image() renderer temaaktiver med faktiske værdier for bredde og højde samt et reserveret højde-bredde-forhold:

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

Outputtet er et figure.blockstudio-media med en inline-aspect-ratio omkring et img, der har faktiske værdier for width, height, loading og decoding.

src tager en temarelativ sti, en absolut sti eller en fuld URL, og attachmentId håndterer billeder fra mediebiblioteket. eager fravælger lazy loading over folden, og sources udsender et <picture>-element med de angivne alternative værdier.

Hjælperen udsender altid kendte værdier for bredde, højde og højde-bredde-forhold, når metadata findes. Lazy-tilstanden bruger kun klasser, attributter, handles og globale værdier fra blockstudio-*.

Metadatamanifestet

Dimensionerne hentes fra assets/media.json, som skrives af Blockstudio\Media_Metadata_Builder i et buildtrin eller manuelt:

PHP
use Blockstudio\Media_Metadata_Builder;

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

Dette skriver deterministiske metadata for temaets aktiver og, med det andet argument, valgfrie WordPress-vedhæftninger. Gendan det, når filer under assets/ ændres.

Media_Metadata_Builder::build( string $root ) returnerer manifestet uden at skrive det; write() er varianten, der gemmer det. Blockstudio\Media_Metadata::reset() rydder cachen i processen efter en genopbygning, hvilket langlivede buildprocesser skal gøre, før de renderer med de opdaterede metadata.

Lazy loading

Indstillingerne performance.media styrer frontend-loaderen:

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

Når lazy er aktiveret, flyttes det faktiske URL til data-src bag en korrekt dimensioneret pladsholder, og den skæringsbaserede loader fra Blockstudio erstatter det, når billedet nærmer sig visningsområdet. rootMargin indlæses på forhånd. skeleton viser den indbyggede indlæsningspladsholder, og metadata angiver, at assets/media.json er i brug.

De to ydeevneprofiler, speed og strict, aktiverer loaderen som standard; compat lader den være deaktiveret. Hver underordnet værdi kan tilsidesætte profilens standardindstilling.

Indstillinger

Den komplette tabel over performance.media-indstillinger.

Statisk prerendering

Mediemetadata er trin to i rækkefølgen for produktionsimplementering.