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