Перейти до вмісту

Медіафайли

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

Статичне попереднє рендерення

Метадані медіафайлів — другий крок у послідовності впровадження для виробничого середовища.