Lewati ke konten

Media

Gambar tema berada di luar pustaka media, jadi WordPress tidak mengetahui dimensinya dan setiap gambar tanpa gaya menggeser tata letak saat dimuat. Blockstudio mengatasi hal tersebut dengan manifes metadata yang dihasilkan, helper template yang selalu mengeluarkan dimensi sebenarnya, dan pemuat malas opsional.

Merender gambar

bs_media_image() merender aset tema dengan lebar, tinggi, dan rasio aspek yang dicadangkan secara nyata:

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)'],
    ],
]);
?>

Outputnya berupa figure.blockstudio-media dengan aspect-ratio sebaris di sekeliling elemen img yang memuat nilai width, height, loading, dan decoding sebenarnya.

src menerima jalur relatif terhadap tema, jalur absolut, atau URL lengkap, sedangkan attachmentId mencakup gambar dari pustaka media. eager menonaktifkan pemuatan malas untuk area atas lipatan, dan sources mengeluarkan elemen <picture> dengan varian yang diberikan.

Helper selalu mengeluarkan nilai lebar, tinggi, dan rasio aspek yang diketahui jika metadata tersedia. Mode malas hanya menggunakan kelas, atribut, handle, dan global blockstudio-*.

Manifes metadata

Dimensi berasal dari assets/media.json, yang ditulis oleh Blockstudio\Media_Metadata_Builder pada langkah build atau secara manual:

PHP
use Blockstudio\Media_Metadata_Builder;

(new Media_Metadata_Builder())->write(
    get_stylesheet_directory(),
    true
);

Ini menulis metadata deterministik untuk aset tema dan, dengan argumen kedua, lampiran WordPress opsional. Buat ulang metadata setiap kali file di dalam assets/ berubah.

Media_Metadata_Builder::build( string $root ) mengembalikan manifes tanpa menulisnya; write() adalah varian yang menyimpannya. Blockstudio\Media_Metadata::reset() menghapus cache dalam proses setelah pembangunan ulang, yang diperlukan oleh proses build berumur panjang sebelum merender menggunakan metadata terbaru.

Pemuatan malas

Pengaturan performance.media mengendalikan pemuat frontend:

JSON
{
  "performance": {
    "media": {
      "lazy": true,
      "skeleton": true,
      "metadata": true,
      "rootMargin": "300px"
    }
  }
}

Jika lazy aktif, URL yang sebenarnya dipindahkan ke data-src di balik placeholder berukuran tepat, lalu pemuat berbasis irisan milik Blockstudio menampilkannya saat gambar mendekati area pandang, dengan rootMargin dimuat terlebih dahulu. skeleton menampilkan placeholder pemuatan bawaan, dan metadata menyatakan bahwa assets/media.json sedang digunakan.

Profil performa speed dan strict performa mengaktifkan loader secara default; compat membiarkannya nonaktif. Setiap nilai anak dapat mengganti default profilnya.

Pengaturan

Tabel opsi lengkap performance.media.

Perenderan Awal Statis

Metadata media adalah langkah kedua dalam urutan penerapan produksi.