Treci la conținut

Media

Imaginile temei se află în afara bibliotecii media, așa că WordPress nu le cunoaște dimensiunile, iar fiecare imagine fără stiluri modifică aspectul paginii cât timp se încarcă. Blockstudio rezolvă această problemă cu un manifest de metadate generat, un helper de șablon care emite întotdeauna dimensiunile reale și un încărcător leneș opțional.

Randarea imaginilor

bs_media_image() randează resursele temei cu lățimea și înălțimea reale și cu un raport de aspect rezervat:

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

Rezultatul este un figure.blockstudio-media cu un aspect-ratio inline în jurul unui img care conține valorile reale width, height, loading și decoding.

src acceptă o cale relativă la temă, o cale absolută sau un URL complet, iar attachmentId acoperă imaginile din biblioteca media. eager dezactivează încărcarea leneșă deasupra zonei vizibile inițial, iar sources emite un element <picture> cu variantele specificate.

Helper-ul emite întotdeauna valorile cunoscute pentru lățime, înălțime și raport de aspect, dacă există metadate. Modul leneș folosește numai clase, atribute, handle-uri și variabile globale blockstudio-*.

Manifestul metadatelor

Dimensiunile provin din assets/media.json, scris de Blockstudio\Media_Metadata_Builder într-o etapă de compilare sau manual:

PHP
use Blockstudio\Media_Metadata_Builder;

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

Aceasta scrie metadate deterministe pentru resursele temei și, cu al doilea argument, pentru atașamente opționale WordPress. Regenerați-le ori de câte ori se modifică fișierele din assets/.

Media_Metadata_Builder::build( string $root ) returnează manifestul fără a-l scrie; write() este varianta care îl salvează. Blockstudio\Media_Metadata::reset() golește memoria cache din proces după reconstruire; procesele de compilare de lungă durată au nevoie de aceasta înainte de a randa folosind metadatele actualizate.

Încărcare leneșă

Setările performance.media controlează încărcătorul frontend:

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

Când lazy este activată, URL reală este mutată în data-src în spatele unui substituent cu dimensiunile corecte, iar încărcătorul Blockstudio, bazat pe intersectare, o înlocuiește pe măsură ce imaginea se apropie de zona vizibilă; rootMargin în avans. skeleton afișează substituentul de încărcare încorporat, iar metadata declară că este utilizat assets/media.json.

Profilurile speed și strict de performanță activează loaderul în mod implicit; compat îl lasă dezactivat. Fiecare valoare copil poate suprascrie valoarea implicită a profilului.

Setări

Tabelul complet al opțiunilor performance.media.

Pre-randare statică

Metadatele media reprezintă a doua etapă în ordinea adoptării pentru producție.