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.
$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 ...>',
];
typeirstylepriekš CSS unmodulepriekš JavaScript. Blockstudio failos balstītie JavaScript līdzekļi izmanto ES moduļus, tostarp iekļautos skriptus.handleir stabils līdzekļa identifikators, ko izmanto Blockstudio renderētājs un filtrsblockstudio/assets/disable. Tas nav obligāti jānorāda ielādei WordPress.urlir 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 irnull.inlinenošķir iekļauto<style>/<script>izvadi no ārējiem failiem.scopeuzskaita kontekstus, kuros līdzeklis tiek lietots: koplietotajiem failiemfrontenduneditor, bet skata/redaktora failiem — tikai vienu.htmlsatur 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.