Prostředky
Blockstudio poskytuje pro vaše bloky zpracování prostředků bez nutnosti konfigurace. Umístěte vedle bloku soubory CSS, SCSS nebo JavaScript a automaticky se zkompilují, minifikují a zařadí do fronty.
- Registrace prostředků: Konvence pojmenování souborů a chování při zařazování do fronty
- Zpracování: Kompilace SCSS, importy modulů ES a minifikace
- Pole kódu: Úprava kódu přímo v poli typu code
Kontrola prostředků bloku
bs_block_assets('theme/card') vrací nalezené prostředky frontendu a plátna editoru zaregistrovaného bloku Blockstudio. Zavolejte ji po registraci bloku, při init nebo později. Neznámé bloky, bloky, které nejsou Blockstudio, a bloky bez prostředků vracejí []. Pomocná funkce blok nevykresluje, nic nezařazuje do fronty ani nespouští kompilaci.
$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 ...>',
];
typejestylepro CSS amodulepro JavaScript. Souborové prostředky Blockstudio používají moduly ES, včetně vložených skriptů JavaScript.handleje stabilní identifikátor prostředku, který používá vykreslovač Blockstudio a filtrblockstudio/assets/disable. V WordPress nemusí být zařazen do fronty.urlje vyřešená URL existujícího kompilovaného prostředku včetně jeho verze, nebo zdrojová URL, pokud kompilovaný soubor neexistuje. U vložených prostředků má hodnotunull.inlinerozlišuje vložený výstup<style>/<script>od externích souborů.scopeuvádí kontexty, ve kterých se prostředek používá:frontendaeditoru sdílených souborů a pouze jeden u souborů view/editor.htmlobsahuje značku připravenou k použití z běžného vykreslovače prostředků. Vložený obsah, rozsahově omezené CSS, vrstvy stylů UI a filtry vypínající prostředky při vykreslení se zpracovávají stejně jako v běžném výstupu bloku.
Chybějící, prázdné, zakázané a nekompilované soubory SCSS se vynechávají. Vyřazují se prostředky rodičovského dokumentu pro administraci a editor bloků zařazené do fronty pomocí WordPress. Seznam je omezen na vlastní nalezené soubory bloku. Nejde o uzávěr závislostí: vnořené bloky, hodnoty polí kódu, handly zařazené do fronty pomocí WordPress, importy modulů CSS, Tailwind a sdílené běhové prostředí UI/Interactivity mohou záviset na vykresleném obsahu. Pro úplný samostatný náhled použijte Render::document(). Zaregistrované definice polí si prohlédněte pomocí bs_block_fields().