Liigu sisu juurde

Varad

Blockstudio pakub plokkidele nullseadistusega varade töötlustorustikku. Asetage failid CSS, SCSS või JavaScript ploki kõrvale ning need kompileeritakse, minimeeritakse ja lisatakse automaatselt järjekorda.

Ploki varade uurimine

bs_block_assets('theme/card') tagastab registreeritud Blockstudio ploki leitud esiotsa ja redaktori lõuendi varad. Kutsuge seda pärast ploki registreerimist, versioonil init või uuemal. Tundmatute, mitte-Blockstudio plokkide ja varadeta plokkide korral tagastatakse []. Abifunktsioon ei renderda plokki, lisa järjekorda ega käivita kompileerimist.

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 on CSS puhul style ja JavaScript puhul module. Blockstudio failipõhised JavaScript varad kasutavad ES-mooduleid, sealhulgas tekstisiseseid skripte.
  • handle on stabiilne varaidentifikaator, mida kasutavad Blockstudio renderdaja ja filter blockstudio/assets/disable. Seda ei pea lisama järjekorda WordPress.
  • url on olemasoleva kompileeritud vara lahendatud URL koos versiooniga või lähte-URL, kui kompileeritud faili pole. Tekstisiseste varade puhul on see null.
  • inline eristab tekstisisest <style>/<script> väljundit välistest failidest.
  • scope loetleb kontekstid, kus vara kehtib: jagatud failide puhul frontend ja editor ning vaate-/redaktorifailide puhul ainult ühe.
  • html sisaldab tavapärase vararenderdaja kasutusvalmis märgendit. Tekstisisu, ulatusega CSS, UI stiilikihte ja renderdusajal rakendatavaid keelamisfiltreid käsitletakse samamoodi nagu tavalise plokiväljundi puhul.

Puuduvad, tühjad, keelatud ja kompileerimata SCSS failid jäetakse välja. Välja jäetakse ka WordPress lisatud administraatori ja plokiredaktori ülemdokumendi varad. Loend hõlmab ainult ploki enda leitud faile. See ei hõlma kõiki sõltuvusi: pesastatud plokid, koodiväljade väärtused, WordPress lisatud käitlejad, mooduli CSS impordid, Tailwind ning jagatud UI/Interactivity käituskeskkonnad võivad sõltuda renderdatud sisust. Täieliku iseseisva eelvaate saamiseks kasutage Render::document()kogu ploki eelvaade. Registreeritud väljamääratluste vaatamiseks kasutage bs_block_fields().