Preskoči na vsebino

Sredstva

Blockstudio zagotavlja cevovod za obdelavo sredstev vaših blokov brez konfiguracije. Datoteke CSS, SCSS ali JavaScript shranite poleg bloka; samodejno bodo prevedene, pomanjšane in dodane v čakalno vrsto.

  • Registracija sredstev: pravila za poimenovanje datotek in njihovo dodajanje v čakalno vrsto
  • Obdelava: prevajanje SCSS, uvozi modulov ES in pomanjševanje
  • Kodna polja: urejanje kode v vrstici z vrsto polja za kodo

Pregled sredstev bloka

bs_block_assets('theme/card') vrne zaznana sredstva za ospredje in platno urejevalnika registriranega bloka Blockstudio. Pokličite ga po registraciji bloka, na init ali novejši različici. Za neznane bloke, bloke, ki niso Blockstudio, in bloke brez sredstev vrne []. Pomožna funkcija bloka ne izriše, ničesar ne doda v čakalno vrsto in ne sproži prevajanja.

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 je style za CSS in module za JavaScript. Datoteke Blockstudio temeljijo na JavaScript in uporabljajo module ES, tudi za vstavljene skripte.
  • handle je stabilni identifikator sredstva, ki ga uporabljata izrisovalnik Blockstudio in filter blockstudio/assets/disable. Ni ga treba dodati v čakalno vrsto WordPress.
  • url je razrešeni URL obstoječega prevedenega sredstva, vključno z njegovo različico, ali izvorni URL, kadar prevedena datoteka ne obstaja. Za vstavljena sredstva je null.
  • inline razlikuje med vstavljenim izhodom <style>/<script> in zunanjimi datotekami.
  • scope navaja kontekste, v katerih se sredstvo uporablja: frontend in editor za datoteke v skupni rabi, za datoteke pogleda ali urejevalnika pa le enega.
  • html vsebuje oznako, pripravljeno za uporabo, iz običajnega izrisovalnika sredstev. Vstavljena vsebina, omejeni CSS, slogovne plasti UI in filtri za onemogočanje ob času izrisa se obravnavajo enako kot običajni izhod bloka.

Manjkajoče, prazne, onemogočene in neprevedene datoteke SCSS so izpuščene. Sredstva nadrejenega dokumenta za skrbniški vmesnik in urejevalnik blokov, dodana v čakalno vrsto z WordPress, so izključena. Seznam je omejen na zaznane datoteke bloka. Ne vključuje vseh odvisnosti: ugnezdeni bloki, vrednosti kodnih polj, ročice, dodane v čakalno vrsto z WordPress, uvozi modulov CSS, Tailwind ter skupna izvajalna okolja UI/Interactivity so lahko odvisni od izrisane vsebine. Za popoln samostojen predogled uporabite Render::document(). Za pregled registriranih definicij polj uporabite bs_block_fields().