Přejít k obsahu

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.

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.

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 pro CSS a module pro JavaScript. Souborové prostředky Blockstudio používají moduly ES, včetně vložených skriptů JavaScript.
  • handle je stabilní identifikátor prostředku, který používá vykreslovač Blockstudio a filtr blockstudio/assets/disable. V WordPress nemusí být zařazen do fronty.
  • url je 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á hodnotu null.
  • inline rozlišuje vložený výstup <style>/<script> od externích souborů.
  • scope uvádí kontexty, ve kterých se prostředek používá: frontend a editor u sdílených souborů a pouze jeden u souborů view/editor.
  • html obsahuje 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().