Przejdź do treści

Zasoby

Blockstudio zapewnia niewymagający konfiguracji potok zasobów dla bloków. Umieść pliki CSS, SCSS lub JavaScript obok bloku, a zostaną automatycznie skompilowane, zminimalizowane i dodane do kolejki.

Sprawdzanie zasobów bloku

bs_block_assets('theme/card') zwraca wykryte zasoby frontendu i obszaru roboczego edytora zarejestrowanego bloku Blockstudio. Wywołaj tę funkcję po rejestracji bloku, od init wzwyż. Nieznane bloki, bloki inne niż Blockstudio oraz bloki bez zasobów zwracają []. Ta funkcja pomocnicza nie renderuje bloku, nie dodaje niczego do kolejki ani nie uruchamia kompilacji.

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 to style dla CSS i module dla JavaScript. Zasoby JavaScript oparte na plikach w Blockstudio używają modułów ES, w tym skryptów wbudowanych.
  • handle to stabilny identyfikator zasobu używany przez renderer Blockstudio i filtr blockstudio/assets/disable. Nie musi być dodany do kolejki w WordPress.
  • url to rozstrzygnięty URL istniejącego skompilowanego zasobu wraz z jego wersją albo źródłowy URL, jeśli plik skompilowany nie istnieje. Dla zasobów wbudowanych ma wartość null.
  • inline odróżnia wbudowany wynik <style>/<script> od plików zewnętrznych.
  • scope zawiera konteksty, w których stosuje się zasób: frontend i editor dla współdzielonych plików, a tylko jeden dla plików widoku/edytora.
  • html zawiera gotowy do użycia znacznik z normalnego renderera zasobów. Treści wbudowane, zakresowe CSS, warstwy stylów UI i filtry wyłączające działające podczas renderowania są obsługiwane tak samo jak w przypadku zwykłego wyniku bloku.

Brakujące, puste, wyłączone i nieskompilowane pliki SCSS są pomijane. Zasoby dokumentu nadrzędnego panelu administracyjnego i edytora bloków dodane do kolejki przez WordPress są wykluczone. Lista obejmuje tylko wykryte pliki należące do bloku. Nie jest to pełne drzewo zależności: zagnieżdżone bloki, wartości pól kodu, uchwyty dodane do kolejki przez WordPress, importy modułów CSS, Tailwind oraz współdzielone środowiska wykonawcze UI/Interactivity mogą zależeć od renderowanej treści. Użyj Render::document(), aby uzyskać kompletny, samodzielny podgląd. Użyj bs_block_fields(), aby sprawdzić zarejestrowane definicje pól.