Siirry sisältöön

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.

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ä.

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-ympäristössä style ja JavaScript-ympäristössä module. Blockstudio-tiedostopohjaiset JavaScript-resurssit käyttävät ES-moduuleja, myös upotetuissa komentosarjoissa.
  • handle on vakaa resurssitunniste, jota Blockstudio-renderöijä ja suodatin blockstudio/assets/disable käyttävät. Sitä ei tarvitse lisätä jonoon WordPress.
  • url on olemassa olevan käännetyn resurssin ratkaistu URL versioineen tai lähteen URL, jos käännettyä tiedostoa ei ole. Sen arvo on null upotetuissa resursseissa.
  • inline erottaa upotetun <style>/<script>-tulosteen ulkoisista tiedostoista.
  • scope luettelee resurssin käyttöympäristöt: jaetuille tiedostoille frontend ja editor, näkymä- ja editoritiedostoille vain toisen.
  • html sisä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().