Zum Inhalt springen

Medien

Theme-Bilder liegen außerhalb der Medienbibliothek. Daher kennt WordPress ihre Abmessungen nicht, und jedes ungestylte Bild verschiebt beim Laden das Layout. Blockstudio schließt diese Lücke mit einem generierten Metadatenmanifest, einer Vorlagenhilfe, die stets echte Abmessungen ausgibt, und einem optionalen Lazy Loader.

Bilder rendern

bs_media_image() rendert Theme-Assets mit tatsächlicher Breite und Höhe sowie einem reservierten Seitenverhältnis:

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

Die Ausgabe ist ein figure.blockstudio-media mit einem Inline-aspect-ratio um ein img, das echte Werte für width, height, loading und decoding enthält.

src akzeptiert einen Theme-relativen Pfad, einen absoluten Pfad oder eine vollständige URL. attachmentId ist für Bilder aus der Medienbibliothek zuständig. eager deaktiviert Lazy Loading oberhalb des sichtbaren Bereichs, und sources gibt ein <picture>-Element mit den angegebenen Alternativen aus.

Wenn Metadaten vorhanden sind, gibt die Hilfe stets bekannte Werte für Breite, Höhe und Seitenverhältnis aus. Der Lazy-Modus verwendet ausschließlich blockstudio-*-Klassen, -Attribute, -Handles und -Globals.

Das Metadatenmanifest

Die Abmessungen stammen aus assets/media.json, das von Blockstudio\Media_Metadata_Builder während eines Build-Schritts oder manuell erstellt wird:

PHP
use Blockstudio\Media_Metadata_Builder;

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

Damit werden deterministische Metadaten für die Assets des Themes geschrieben. Mit dem zweiten Argument werden zusätzlich optionale WordPress-Anhänge aufgenommen. Erzeuge das Manifest neu, wenn sich Dateien unter assets/ ändern.

Media_Metadata_Builder::build( string $root ) gibt das Manifest zurück, ohne es zu schreiben; write() ist die Variante, die es speichert. Blockstudio\Media_Metadata::reset() leert nach einem Neuaufbau den In-Process-Cache. Das ist bei langlebigen Build-Prozessen erforderlich, bevor sie mit den aktualisierten Metadaten rendern.

Lazy Loading

Die Einstellungen performance.media steuern den Frontend-Loader:

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

Ist lazy aktiviert, wird das echte URL hinter einem korrekt dimensionierten Platzhalter zu data-src verschoben. Der auf Intersection basierende Loader von Blockstudio setzt es ein, sobald sich das Bild dem Viewport nähert, und rootMargin lädt es vorab. skeleton zeigt den integrierten Ladeplatzhalter an, und metadata gibt an, dass assets/media.json verwendet wird.

Die Performance-Profile speed und strict aktivieren den Loader standardmäßig; compat lässt ihn deaktiviert. Jeder untergeordnete Wert kann die Standardeinstellung seines Profils überschreiben.

Einstellungen

Die vollständige Tabelle der performance.media-Optionen.

Statisches Vorab-Rendering

Medienmetadaten sind der zweite Schritt der empfohlenen Reihenfolge für die Einführung in der Produktion.