Перейти к содержимому

Медиафайлы

Изображения темы хранятся вне библиотеки медиафайлов, поэтому WordPress не знает их размеров, и каждое неоформленное изображение сдвигает макет при загрузке. Blockstudio решает эту проблему с помощью автоматически созданного манифеста метаданных, вспомогательной функции шаблона, которая всегда указывает реальные размеры, и дополнительного механизма отложенной загрузки.

Отрисовка изображений

bs_media_image() выводит ресурсы темы с реальными значениями ширины и высоты и зарезервированными пропорциями сторон:

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

Вывод представляет собой figure.blockstudio-media со встроенным aspect-ratio вокруг img, содержащим реальные значения width, height, loading и decoding.

src принимает путь относительно темы, абсолютный путь или полный URL, а attachmentId предназначен для изображений из библиотеки медиафайлов. eager отключает отложенную загрузку в верхней части страницы, а sources создает элемент <picture> с указанными альтернативами.

Если метаданные доступны, вспомогательная функция всегда указывает известные значения ширины, высоты и пропорций сторон. Режим отложенной загрузки использует только классы, атрибуты, дескрипторы и глобальные переменные blockstudio-*.

Манифест метаданных

Размеры берутся из assets/media.json, который создается с помощью Blockstudio\Media_Metadata_Builder во время сборки или вручную:

PHP
use Blockstudio\Media_Metadata_Builder;

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

Команда записывает детерминированные метаданные для ресурсов темы и, если указан второй аргумент, необязательных вложений WordPress. Повторно создавайте манифест при каждом изменении файлов в assets/.

Media_Metadata_Builder::build( string $root ) возвращает манифест, не записывая его; write() — вариант, который сохраняет результат. Blockstudio\Media_Metadata::reset() очищает кэш в текущем процессе после пересборки. Это необходимо долгоживущим процессам сборки перед отрисовкой с обновленными метаданными.

Отложенная загрузка

Настройки performance.media управляют загрузчиком внешнего интерфейса:

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

Если включен lazy, настоящий URL перемещается в data-src за заполнителем правильного размера, а загрузчик Blockstudio на основе пересечения подставляет его, когда изображение приближается к области просмотра; rootMargin загружает изображение заранее. skeleton показывает встроенный заполнитель загрузки, а metadata объявляет, что используется assets/media.json.

В профилях производительности speed и strict производительности загрузчик включен по умолчанию; в профиле compat он отключен. Для каждого дочернего параметра можно задать значение, отличное от значения по умолчанию в профиле.

Настройки

Полная таблица параметров performance.media.

Статическая предварительная отрисовка

Метаданные медиафайлов — второй шаг внедрения для производственной среды.