Resurssit
Blockstudio tarjoaa lohkoillesi resurssiputken ilman määrityksiä. Lisää CSS-, SCSS- tai JavaScript-tiedosto lohkosi viereen, niin se käännetään ja pienennetään sekä lisätään automaattisesti jonoon.
- Resurssien rekisteröinti: Tiedostojen nimeämiskäytännöt ja jonoon lisäys
- Käsittely: SCSS-käännös, ES-moduulien tuonnit ja pienennys
- Koodikenttä: Koodin muokkaaminen suoraan koodikentän tyypillä
Lohkon resurssien tarkastelu
bs_block_assets('theme/card') palauttaa rekisteröidyn Blockstudio-lohkon löydetyt käyttöliittymän ja editorin piirtoalueen resurssit. Kutsu sitä lohkon rekisteröinnin jälkeen, ajankohdasta init alkaen. Tuntemattomat lohkot, muut kuin Blockstudio-lohkot ja lohkot, joilla ei ole resursseja, palauttavat arvon []. Aputoiminto ei piirrä lohkoa, lisää mitään jonoon eikä käynnistä käännö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 ...>',
];
typeon CSS-ympäristössästyleja JavaScript-ympäristössämodule. Blockstudio-tiedostopohjaiset JavaScript-resurssit käyttävät ES-moduuleja, myös upotetuissa komentosarjoissa.handleon vakaa resurssitunniste, jota Blockstudio-renderöijä ja suodatinblockstudio/assets/disablekäyttävät. Sitä ei tarvitse lisätä jonoon WordPress.urlon olemassa olevan käännetyn resurssin ratkaistu URL versioineen tai lähteen URL, jos käännettyä tiedostoa ei ole. Sen arvo onnullupotetuissa resursseissa.inlineerottaa upotetun<style>/<script>-tulosteen ulkoisista tiedostoista.scopeluettelee resurssin käyttöympäristöt: jaetuille tiedostoillefrontendjaeditor, näkymä- ja editoritiedostoille vain toisen.htmlsisältää normaalin resurssirenderöijän valmiin tunnisteen. Upotettu sisältö, rajattu CSS, UI-tyylikerrokset ja renderöinnin aikaiset käytöstäpoistosuodattimet käsitellään samalla tavalla kuin tavallinen lohkotuloste.
Puuttuvat, tyhjät, käytöstä poistetut ja kääntämättömät SCSS-tiedostot jätetään pois. Jonoon lisätyt WordPress-hallinnan ylläpitonäkymän ja lohkoeditorin päädokumentin resurssit rajataan pois. Luettelo kattaa vain lohkon omat löydetyt tiedostot. Se ei sisällä kaikkia riippuvuuksia: sisäkkäiset lohkot, koodikenttien arvot, jonoon lisätyt WordPress-tunnisteet, moduulien CSS-tuonnit, Tailwind ja jaetut UI-/vuorovaikutusaikaiset ympäristöt voivat riippua renderöidystä sisällöstä. Käytä Render::document() täydelliseen itsenäiseen esikatseluun. Tarkastele rekisteröityjä kenttämäärittelyjä komennolla bs_block_fields().