Pāriet uz saturu

Resursi

Blockstudio nodrošina bloku resursu konveijeru bez konfigurācijas. Novietojiet CSS, SCSS vai JavaScript failus blakus blokam, un tie tiks automātiski kompilēti, minimizēti un pievienoti rindai.

  • Aktīvu reģistrēšana: failu nosaukumu konvencijas un pievienošanas rindai darbība
  • Apstrāde: SCSS kompilēšana, ES moduļu imports un minimizēšana
  • Koda lauks: koda rediģēšana iekļautā veidā, izmantojot koda lauka tipu

Bloka līdzekļu pārbaude

bs_block_assets('theme/card') atgriež reģistrēta Blockstudio bloka atklātos priekšgala un redaktora kanvas līdzekļus. Izsauciet to pēc bloka reģistrēšanas, sākot ar init. Nezināmiem blokiem, blokiem, kas nav Blockstudio, un blokiem bez līdzekļiem tiek atgriezts []. Palīgfunkcija bloku nerenderē, neko nenorāda ielādei un nepalaiž kompilēšanu.

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 ir style priekš CSS un module priekš JavaScript. Blockstudio failos balstītie JavaScript līdzekļi izmanto ES moduļus, tostarp iekļautos skriptus.
  • handle ir stabils līdzekļa identifikators, ko izmanto Blockstudio renderētājs un filtrs blockstudio/assets/disable. Tas nav obligāti jānorāda ielādei WordPress.
  • url ir esošā kompilētā līdzekļa atrisinātais URL, ieskaitot tā versiju, vai avota URL, ja kompilētais fails neeksistē. Iekļautajiem līdzekļiem tas ir null.
  • inline nošķir iekļauto <style>/<script> izvadi no ārējiem failiem.
  • scope uzskaita kontekstus, kuros līdzeklis tiek lietots: koplietotajiem failiem frontend un editor, bet skata/redaktora failiem — tikai vienu.
  • html satur lietošanai gatavu tagu no parastā līdzekļu renderētāja. Iekļautais saturs, tvērumā ierobežotais CSS, UI stilu slāņi un renderēšanas laikā iedarbinātie atspējošanas filtri tiek apstrādāti tāpat kā parastā bloka izvade.

Trūkstoši, tukši, atspējoti un nekompilēti SCSS faili tiek izlaisti. WordPress ielādētie administrēšanas un bloku redaktora vecākā dokumenta līdzekļi ir izslēgti. Sarakstā iekļauti tikai paša bloka atklātie faili. Tā nav atkarību pilna kopa: ligzdotie bloki, koda lauku vērtības, WordPress ielādētie apstrādes vienumi, moduļu CSS importi, Tailwind un koplietotās UI/Interactivity izpildvides var būt atkarīgas no renderētā satura. Izmantojiet PriekšskatījumsRender::document(), lai izveidotu pilnīgu, pašpietiekamu priekšskatījumu. Izmantojiet bs_block_fields(), lai pārbaudītu reģistrētās lauku definīcijas.