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.
- Eszközök regisztrálása: fájlelnevezési konvenciók és betöltési viselkedés
- Feldolgozás: SCSS fordítás, ES-modulimportok és tömörítés
- Kódmező: kód szerkesztése a kódmező típusával
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.
$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
typeCSS eseténstyle, JavaScript esetén pedigmodule. A Blockstudio fájlalapú JavaScript eszközei ES-modulokat használnak, a beágyazott szkripteket is beleértve. - A
handleaz a stabil eszközazonosító, amelyet a Blockstudio megjelenítője és ablockstudio/assets/disableszűrő használ. Nem szükséges betölteni a WordPress rendszerben. - A
urla 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énnull. - A
inlinekülönbözteti meg a beágyazott<style>/<script>kimenetet a külső fájloktól. - A
scopefelsorolja azokat a kontextusokat, amelyekre az eszköz érvényes: megosztott fájlok eseténfrontendéseditor, a nézet- és szerkesztőfájlok esetén pedig csak az egyiket. - A
htmla 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.