Ga naar de inhoud

Media

Thema-afbeeldingen staan buiten de mediabibliotheek, dus WordPress kent hun afmetingen niet en elke afbeelding zonder opmaak verschuift de lay-out tijdens het laden. Blockstudio vult die leemte op met een gegenereerd metadatamanifest, een sjabloonhelper die altijd echte afmetingen opgeeft en een optionele lazyloader.

Afbeeldingen renderen

bs_media_image() rendert thema-assets met de echte breedte en hoogte en een gereserveerde beeldverhouding:

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

De uitvoer is een figure.blockstudio-media met inline aspect-ratio rond een img met echte waarden voor width, height, loading en decoding.

src accepteert een themarelief pad, een absoluut pad of een volledige URL; attachmentId is bedoeld voor afbeeldingen uit de mediabibliotheek. Met eager schakel je lazy loading boven de vouw uit, en sources geeft een element <picture> met de opgegeven alternatieven weer.

Als er metadata bestaat, geeft de helper altijd de bekende waarden voor breedte, hoogte en beeldverhouding weer. De lazy-modus gebruikt uitsluitend blockstudio-*-klassen, attributen, handles en globale variabelen.

Het metadatamanifest

Afmetingen zijn afkomstig uit assets/media.json, geschreven door Blockstudio\Media_Metadata_Builder in een buildstap of handmatig:

PHP
use Blockstudio\Media_Metadata_Builder;

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

Hiermee worden deterministische metadata voor de assets van het thema weggeschreven en, met het tweede argument, optionele bijlagen van WordPress. Genereer het opnieuw wanneer bestanden in assets/ veranderen.

Media_Metadata_Builder::build( string $root ) geeft het manifest terug zonder het op te slaan; write() is de variant die het wel bewaart. Blockstudio\Media_Metadata::reset() wist de cache in het huidige proces na een nieuwe build. Langlopende buildprocessen hebben dit nodig voordat ze met verse metadata renderen.

Lazy loading

De instellingen van performance.media bepalen hoe de frontend-loader werkt:

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

Als lazy is ingeschakeld, wordt de echte URL verplaatst naar data-src achter een placeholder van de juiste afmetingen. De op intersectie gebaseerde loader van Blockstudio vervangt die zodra de afbeelding het zichtbare gebied nadert en laadt rootMargin alvast vooraf. skeleton toont de ingebouwde laadplaceholder en metadata geeft aan dat assets/media.json wordt gebruikt.

De speed en strict prestatieprofielen schakelen de loader standaard in; compat laat deze uitgeschakeld. Elke onderliggende waarde kan de standaardinstelling van het profiel overschrijven.

Instellingen

De volledige optietabel van performance.media.

Statische voorrendering

Mediametadata is stap twee in de aanbevolen productievolgorde.