Към съдържанието

Медия

Изображенията на темата са извън медийната библиотека, затова 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.

Статично предварително изобразяване

Метаданните за медията са втората стъпка от реда за внедряване в производствена среда.