Ugrás a tartalomhoz

Eszközök

A Blockstudio konfiguráció nélkül biztosít eszközfeldolgozási folyamatot a blokkokhoz. Helyezzen CSS, SCSS vagy JavaScript fájlokat a blokk mellé, és a rendszer automatikusan lefordítja, tömöríti és betölti őket.

Egy blokk eszközeinek vizsgálata

A bs_block_assets('theme/card') egy regisztrált Blockstudio blokk felismert frontend- és szerkesztővászon-eszközeit adja vissza. A blokk regisztrálása után, init vagy később hívja meg. Ismeretlen blokkok, nem Blockstudio blokkok, valamint eszközök nélküli blokkok esetén [] értéket ad vissza. A segédfüggvény nem jeleníti meg a blokkot, nem tölt be semmit, és nem indít fordítást.

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 ...>',
];
  • A type CSS esetén style, JavaScript esetén pedig module. A Blockstudio fájlalapú JavaScript eszközei ES-modulokat használnak, a beágyazott szkripteket is beleértve.
  • A handle az a stabil eszközazonosító, amelyet a Blockstudio megjelenítője és a blockstudio/assets/disable szűrő használ. Nem szükséges betölteni a WordPress rendszerben.
  • A url a meglévő lefordított eszköz feloldott URL értéke, annak verziójával együtt, vagy a forrás-URL, ha nincs lefordított fájl. Beágyazott eszközök esetén null.
  • A inline különbözteti meg a beágyazott <style>/<script> kimenetet a külső fájloktól.
  • A scope felsorolja azokat a kontextusokat, amelyekre az eszköz érvényes: megosztott fájlok esetén frontend és editor, a nézet- és szerkesztőfájlok esetén pedig csak az egyiket.
  • A html a normál eszközmegjelenítő által előállított, használatra kész címkét tartalmazza. A beágyazott tartalmak, a hatókörhöz kötött CSS, UI stílusrétegek és a megjelenítéskor érvényes letiltó szűrők kezelése ugyanúgy történik, mint a szokásos blokk-kimenet esetén.

A hiányzó, üres, letiltott és le nem fordított SCSS fájlok kimaradnak. A WordPress által betöltött adminisztrációs és blokkszerkesztői szülődokumentum-eszközök nem szerepelnek a listában. A lista csak a blokk saját, felismert fájljaira terjed ki. Nem tartalmazza a függőségek teljes láncát: a beágyazott blokkok, a kódmezők értékei, a WordPress által betöltött fogantyúk, a modulok CSS importjai, a Tailwind, valamint a megosztott UI/Interactivity futtatókörnyezetek a megjelenített tartalomtól függhetnek. A teljes, önállóan használható előnézethez használja a Render::document() lehetőséget. A regisztrált meződefiníciók vizsgálatához használja a bs_block_fields() lehetőséget.