Preskočiť na obsah

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.

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.

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 pre CSS a module pre JavaScript. Súbory JavaScript založené na súboroch od Blockstudio používajú moduly ES vrátane vložených skriptov.
  • handle je stabilný identifikátor zdroja, ktorý používa vykresľovač Blockstudio a filter blockstudio/assets/disable. V WordPress ho netreba zaradiť do frontu.
  • url je 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 je null.
  • inline rozlišuje vložený výstup <style>/<script> od externých súborov.
  • scope uvádza kontexty, v ktorých sa zdroj používa: frontend a editor pre zdieľané súbory a iba jeden kontext pre súbory zobrazenia alebo editora.
  • html obsahuje 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().