Medya
Tema görselleri medya kitaplığının dışında bulunduğundan WordPress bunların boyutlarını bilmez ve biçimlendirilmemiş her görsel yüklenirken sayfa düzeni kayar. Blockstudio, oluşturulan üst veri bildirimi, her zaman gerçek boyutları veren bir şablon yardımcısı ve isteğe bağlı tembel yükleyiciyle bu açığı kapatır.
Görselleri işleme
bs_media_image(), tema varlıklarını gerçek genişlik ve yükseklikle ve ayrılmış bir en-boy oranıyla oluşturur:
<?php
echo bs_media_image([
'src' => 'assets/images/hero.webp',
'alt' => 'Hero',
'class' => 'hero-media',
'sources' => [
['srcset' => '/hero-small.webp', 'media' => '(max-width: 640px)'],
],
]);
?>
Çıktı, gerçek width, height, loading ve decoding değerlerini taşıyan bir img çevresinde satır içi aspect-ratio bulunan bir figure.blockstudio-media öğesidir.
src tema kök dizinine göreli bir yolu, mutlak bir yolu veya tam bir URL kabul eder; attachmentId ise medya kitaplığı görsellerini kapsar. eager, sayfanın üst kısmındaki öğelerde tembel yüklemeyi devre dışı bırakır; sources ise verilen alternatiflerle bir <picture> öğesi oluşturur.
Üst veri mevcut olduğunda yardımcı, bilinen genişlik, yükseklik ve en-boy oranı değerlerini her zaman oluşturur. Tembel yükleme modu yalnızca blockstudio-* sınıflarını, özniteliklerini, tanıtıcılarını ve genel değişkenlerini kullanır.
Üst veri bildirimi
Boyutlar, derleme adımında Blockstudio\Media_Metadata_Builder tarafından veya elle yazılan assets/media.json kaynağından alınır:
use Blockstudio\Media_Metadata_Builder;
(new Media_Metadata_Builder())->write(
get_stylesheet_directory(),
true
);
Bu işlem, temanın varlıkları için belirleyici üst veriler yazar ve ikinci bağımsız değişkenle isteğe bağlı WordPress eklerini de dahil eder. assets/ altındaki dosyalar değiştiğinde bildirimi yeniden oluşturun.
Media_Metadata_Builder::build( string $root ), bildirimi yazmadan döndürür; kalıcılaştıran varyant ise write()‘dir.
Blockstudio\Media_Metadata::reset(), yeniden oluşturma sonrasında süreç içi önbelleği temizler. Uzun ömürlü derleme süreçlerinin yeni üst verilerle oluşturma yapabilmesi için bu gerekir.
Tembel yükleme
performance.media ayarları ön yüz yükleyicisini yönetir:
{
"performance": {
"media": {
"lazy": true,
"skeleton": true,
"metadata": true,
"rootMargin": "300px"
}
}
}
lazy etkin olduğunda, gerçek URL doğru boyutlandırılmış bir yer tutucunun arkasında data-src konumuna taşınır; Blockstudio tarafından kullanılan kesişim tabanlı yükleyici, görsel görüntü alanına yaklaşırken onu rootMargin önceden değiştirir. skeleton yerleşik yükleme yer tutucusunu gösterir; metadata ise assets/media.json kullanımda olduğunu bildirir.
speed ve strict performans profilleri, yükleyiciyi varsayılan olarak etkinleştirir; compat ise kapalı tutar. Her alt değer profil varsayılanını geçersiz kılabilir.
Seçenek tablosunun tamamı
performance.mediabölümündedir.
Medya üst verisi, üretime geçiş sırasındaki ikinci adımdır.