Przejdź do treści

Media

Obrazy motywu znajdują się poza biblioteką mediów, więc WordPress nie zna ich wymiarów, a każdy obraz bez stylów przesuwa układ podczas wczytywania. Blockstudio rozwiązuje ten problem za pomocą generowanego manifestu metadanych, funkcji szablonu, która zawsze emituje rzeczywiste wymiary, oraz opcjonalnego mechanizmu leniwego ładowania.

Renderowanie obrazów

bs_media_image() renderuje zasoby motywu z rzeczywistą szerokością i wysokością oraz z zarezerwowanym współczynnikiem proporcji:

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

Wynikiem jest figure.blockstudio-media z wbudowanym aspect-ratio wokół elementu img zawierającego rzeczywiste wartości width, height, loading i decoding.

src przyjmuje ścieżkę względną względem motywu, ścieżkę bezwzględną lub pełny adres URL, a attachmentId obsługuje obrazy z biblioteki mediów. eager wyłącza leniwe ładowanie w górnej części strony, a sources emituje element <picture> z podanymi alternatywami.

Jeśli metadane są dostępne, funkcja pomocnicza zawsze emituje znane wartości szerokości, wysokości i współczynnika proporcji. Tryb leniwego ładowania korzysta wyłącznie z klas, atrybutów, uchwytów i zmiennych globalnych blockstudio-*.

Manifest metadanych

Wymiary pochodzą z assets/media.json, zapisywanego przez Blockstudio\Media_Metadata_Builder w ramach kompilacji lub ręcznie:

PHP
use Blockstudio\Media_Metadata_Builder;

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

Zapisuje to deterministyczne metadane zasobów motywu oraz, przy użyciu drugiego argumentu, opcjonalnych załączników WordPress. Wygeneruj je ponownie po każdej zmianie plików w assets/.

Media_Metadata_Builder::build( string $root ) zwraca manifest bez zapisywania go; write() to wariant, który go utrwala. Blockstudio\Media_Metadata::reset() czyści pamięć podręczną w bieżącym procesie po ponownej kompilacji. Długotrwałe procesy kompilacji muszą wywołać tę funkcję przed renderowaniem z użyciem nowych metadanych.

Leniwe ładowanie

Ustawienia performance.media sterują ładowaniem po stronie frontendu:

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

Gdy włączona jest opcja lazy, właściwy URL jest przenoszony do data-src za prawidłowo zwymiarowanym elementem zastępczym. Mechanizm ładowania Blockstudio, oparty na obserwowaniu przecięcia z obszarem widoku, podmienia go, gdy obraz zbliża się do tego obszaru, a rootMargin robi to wcześniej. skeleton wyświetla wbudowany element zastępczy ładowania, a metadata deklaruje, że używana jest opcja assets/media.json.

Profile speed i strictwydajnościowe domyślnie włączają mechanizm ładowania, natomiast compat pozostawia go wyłączonym. Każda wartość podrzędna może zastąpić wartość domyślną profilu.

Ustawienia

Pełna tabela opcji performance.media.

Wstępne renderowanie statyczne

Metadane multimediów to drugi krok w kolejności wdrażania produkcyjnego.