Zdroje
Blockstudio poskytuje pre vaše bloky proces spracovania zdrojových súborov bez potreby konfigurácie. Uložte súbory CSS, SCSS alebo JavaScript vedľa bloku a automaticky sa skompilujú, minifikujú a zaradia do frontu.
- Registrácia zdrojov: Konvencie pomenúvania súborov a správanie pri zaraďovaní do frontu
- Spracovanie:SCSS kompilácia, importy modulov ES a minifikácia
- Pole kódu: Úprava kódu priamo v poli kódu
Kontrola zdrojov bloku
bs_block_assets('theme/card') vracia nájdené zdroje frontendu a plátna editora registrovaného bloku Blockstudio. Volajte ho po registrácii bloku, pri init alebo neskôr. Neznáme bloky, bloky, ktoré nie sú Blockstudio, a bloky bez zdrojov vracajú []. Pomocná funkcia blok nevykresľuje, nič nezaraďuje do frontu ani nespúšťa kompiláciu.
$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 ...>',
];
typejestylepre CSS amodulepre JavaScript. Súbory JavaScript založené na súboroch od Blockstudio používajú moduly ES vrátane vložených skriptov.handleje stabilný identifikátor zdroja, ktorý používa vykresľovač Blockstudio a filterblockstudio/assets/disable. V WordPress ho netreba zaradiť do frontu.urlje vyriešená URL existujúceho skompilovaného zdroja vrátane jeho verzie, prípadne zdrojová URL, ak skompilovaný súbor neexistuje. Pri vložených zdrojoch jenull.inlinerozlišuje vložený výstup<style>/<script>od externých súborov.scopeuvádza kontexty, v ktorých sa zdroj používa:frontendaeditorpre zdieľané súbory a iba jeden kontext pre súbory zobrazenia alebo editora.htmlobsahuje značku pripravenú na použitie z bežného vykresľovača zdrojov. S vloženým obsahom, ohraničeným CSS, vrstvami štýlov UI a filtrami zakazujúcimi vykreslenie sa zaobchádza rovnako ako pri bežnom výstupe bloku.
Chýbajúce, prázdne, zakázané a neskompilované súbory SCSS sa vynechajú. Vylúčia sa administrátorské zdroje zaradené do frontu cez WordPress aj zdroje nadradeného dokumentu editora blokov. Zoznam obsahuje iba nájdené súbory patriace samotnému bloku. Nejde o úplný zoznam závislostí: vnorené bloky, hodnoty polí s kódom, obslužné prvky zaradené do frontu cez WordPress, importy modulov CSS, Tailwind a zdieľané prostredia UI/Interactivity môžu závisieť od vykresleného obsahu. Na úplný samostatný náhľad použite Render::document()Ukážka. Na kontrolu registrovaných definícií polí použite bs_block_fields().