İçeriğe geç

Varlıklar

Blockstudio, bloklarınız için sıfır yapılandırmalı bir varlık hattı sağlar. CSS, SCSS veya JavaScript dosyalarını bloğunuzun yanına bırakın; bu dosyalar otomatik olarak derlenir, küçültülür ve sıraya alınır.

  • Varlıkları kaydetme: Dosya adlandırma kuralları ve sıraya alma davranışı
  • İşleme:SCSS derlemesi, ES modülü içe aktarımları ve küçültme
  • Kod alanı: Kod alanı türüyle satır içi kod düzenleme

Bir Bloğun Varlıklarını İnceleme

bs_block_assets('theme/card'), kayıtlı bir Blockstudio bloğunun keşfedilen ön yüz ve düzenleyici tuvali varlıklarını döndürür. Blok kaydından sonra, init veya daha sonraki bir aşamada çağırın. Bilinmeyen bloklar, Blockstudio olmayan bloklar ve varlığı bulunmayan bloklar [] döndürür. Yardımcı işlev bloğu görüntülemez, hiçbir şeyi kuyruğa almaz veya derlemeyi tetiklemez.

PHP
$assets = bs_block_assets('theme/card');

// Each entry has this shape:
[
  'type' => 'style',
  'handle' => 'blockstudio-theme-card-style-css',
  'url' => '/wp-content/blockstudio/cache/.../style-123.css?ver=123',
  'inline' => false,
  'scope' => ['frontend', 'editor'],
  'html' => '<link ...>',
];
  • type, CSS için style, JavaScript için module değerindedir. Blockstudio dosya tabanlı JavaScript varlıkları, satır içi komut dosyaları da dahil olmak üzere ES modüllerini kullanır.
  • handle, Blockstudio oluşturucusunun ve blockstudio/assets/disable filtresinin kullandığı kararlı varlık tanımlayıcısıdır. WordPress içinde kuyruğa alınması gerekmez.
  • url, sürümü de dahil olmak üzere mevcut derlenmiş varlığın çözümlenmiş URL değeridir; derlenmiş dosya yoksa kaynak URL değeridir. Satır içi varlıklar için null değerindedir.
  • inline, satır içi <style>/<script> çıktısını harici dosyalardan ayırır.
  • scope, varlığın geçerli olduğu bağlamları listeler: paylaşılan dosyalar için frontend ve editor; görünüm/düzenleyici dosyaları için yalnızca biri.
  • html, normal varlık oluşturucusunun kullanıma hazır etiketini içerir. Satır içi içerik, kapsamlandırılmış CSS, UI stil katmanları ve oluşturma zamanındaki devre dışı bırakma filtreleri, sıradan blok çıktısındakiyle aynı şekilde işlenir.

Eksik, boş, devre dışı ve derlenmemiş SCSS dosyaları listelenmez. WordPress tarafından kuyruğa alınan yönetim ve blok düzenleyicisinin üst belge varlıkları hariç tutulur. Liste, bloğun keşfedilen kendi dosyalarıyla sınırlıdır. Bu, bağımlılıkların tamamını kapsamaz: iç içe bloklar, kod alanı değerleri, WordPress tarafından kuyruğa alınan tanıtıcılar, modül CSS içe aktarımları, Tailwind ve paylaşılan UI/Interactivity çalışma zamanları, oluşturulan içeriğe bağlı olabilir. Kendi kendine yeterli, eksiksiz bir önizleme için Render::document() kullanın. Kayıtlı alan tanımlarını incelemek için bs_block_fields() kullanın.