Медиафайлы
Изображения темы хранятся вне библиотеки медиафайлов, поэтому WordPress не знает их размеров, и каждое неоформленное изображение сдвигает макет при загрузке. Blockstudio решает эту проблему с помощью автоматически созданного манифеста метаданных, вспомогательной функции шаблона, которая всегда указывает реальные размеры, и дополнительного механизма отложенной загрузки.
Отрисовка изображений
bs_media_image() выводит ресурсы темы с реальными значениями ширины и высоты и зарезервированными пропорциями сторон:
<?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 во время сборки или вручную:
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 управляют загрузчиком внешнего интерфейса:
{
"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.
Статическая предварительная отрисовка
Метаданные медиафайлов — второй шаг внедрения для производственной среды.