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.
- Rejestrowanie zasobów: konwencje nazewnictwa plików i sposób dodawania do kolejki
- Przetwarzanie: kompilacja SCSS, importy modułów ES i minifikacja
- Pole kodu: edycja kodu wbudowanego za pomocą typu pola kodu
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.
$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 ...>',
];
typetostyledla CSS imoduledla JavaScript. Zasoby JavaScript oparte na plikach w Blockstudio używają modułów ES, w tym skryptów wbudowanych.handleto stabilny identyfikator zasobu używany przez renderer Blockstudio i filtrblockstudio/assets/disable. Nie musi być dodany do kolejki w WordPress.urlto 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.inlineodróżnia wbudowany wynik<style>/<script>od plików zewnętrznych.scopezawiera konteksty, w których stosuje się zasób:frontendieditordla współdzielonych plików, a tylko jeden dla plików widoku/edytora.htmlzawiera 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.