Медіафайли
Зображення теми зберігаються поза бібліотекою медіафайлів, тому 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.
Метадані медіафайлів — другий крок у послідовності впровадження для виробничого середовища.