Treci la conținut

Resurse

Blockstudio oferă o conductă de procesare a resurselor fără configurare pentru blocuri. Plasați fișiere CSS, SCSS sau JavaScript lângă bloc, iar acestea vor fi compilate, minificate și adăugate automat în coadă.

  • Înregistrarea resurselor: Convenții de denumire a fișierelor și comportamentul adăugării în coadă
  • Procesare: compilare SCSS, importuri de module ES și minificare
  • Câmp de cod: Editare de cod inline prin tipul de câmp pentru cod

Inspectarea resurselor unui bloc

bs_block_assets('theme/card') returnează resursele descoperite pentru interfața publică și pentru pânza editorului ale unui bloc Blockstudio înregistrat. Apelați-l după înregistrarea blocului, în init sau o versiune ulterioară. Blocurile necunoscute, cele care nu sunt blocuri Blockstudio și cele fără resurse returnează []. Funcția auxiliară nu randează blocul, nu pune nimic în coadă și nu declanșează compilarea.

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 este style pentru CSS și module pentru JavaScript. Resursele JavaScript bazate pe fișiere ale Blockstudio folosesc module ES, inclusiv scripturile inline.
  • handle este identificatorul stabil al resursei folosit de randărul Blockstudio și de filtrul blockstudio/assets/disable. Nu este necesar să fie pus în coadă în WordPress.
  • url este URL rezolvat al resursei compilate existente, inclusiv versiunea acesteia, sau URL sursei atunci când nu există un fișier compilat. Pentru resursele inline, este null.
  • inline diferențiază rezultatul inline <style>/<script> de fișierele externe.
  • scope enumeră contextele în care se aplică resursa: frontend și editor pentru fișierele partajate și doar unul pentru fișierele view/editor.
  • html conține eticheta gata de utilizare generată de randărul obișnuit de resurse. Conținutul inline, CSS cu domeniu specific, straturile de stil UI și filtrele care dezactivează resursele la randare sunt gestionate la fel ca în cazul rezultatului obișnuit al unui bloc.

Fișierele SCSS lipsă, goale, dezactivate și necompilate sunt omise. Resursele documentului părinte din admin și din editorul de blocuri, puse în coadă de WordPress, sunt excluse. Lista se limitează la fișierele proprii ale blocului, descoperite de sistem. Nu include toate dependențele: blocurile imbricate, valorile câmpurilor de cod, handle-urile puse în coadă de WordPress, importurile CSS ale modulelor, Tailwind și execuțiile partajate UI/Interactivity pot depinde de conținutul randat. Folosiți Render::document() pentru o previzualizare completă, autonomă. Folosiți bs_block_fields() pentru a inspecta definițiile câmpurilor înregistrate.