Rejestrowanie zasobów
Blockstudio automatycznie dodaje do kolejki wszystkie pliki z rozszerzeniami .css, .scss i .js, gdy blok jest używany na stronie. Sposób dodawania zasobów do kolejki można określić za pomocą jednej z poniższych nazw plików. * to symbol wieloznaczny, który można zastąpić dowolnym wybranym ciągiem znaków.
W plikach CSS i SCSS bloku %selector% rozwija się do klasy opakowującej przypisanej do danego bloku. Pozwala to wskazać ten sam element, do którego dodawana jest klasa bs_get_scoped_class(), nawet jeśli plik nie jest zasobem przypisanym do bloku.
| Wzorzec | Działanie |
|---|---|
*.(s)css |
Dodaje jako znacznik <link> w edytorze i na stronie |
*.inline.(s)css |
Dodaje zawartość wbudowanego znacznika <style> w edytorze i na stronie |
*.editor.(s)css |
Dodaje jako znacznik <link> tylko w edytorze |
*.scoped.(s)css |
Dodaje przypisaną zawartość wbudowanego znacznika <style> w edytorze i na stronie |
*.js |
Dodaje jako znacznik <script> w edytorze i na stronie |
*.inline.js |
Dodaje zawartość wbudowanego znacznika <script> w edytorze i na stronie |
*.editor.js |
Dodaje jako znacznik <script> tylko w edytorze |
*.view.js |
Dodaje jako znacznik <script> tylko na stronie |
Uwaga
Notacja z myślnikami (
*-inline.css,*-editor.cssitp.) jest nadal obsługiwana ze względu na zgodność wsteczną, ale została oznaczona jako przestarzała. W nowych blokach używaj notacji z kropkami.
Wbudowane
Style i skrypty wbudowane mają tę zaletę, że są renderowane bezpośrednio na stronie jako znaczniki style lub script. Może to przyspieszyć ładowanie, ponieważ eliminuje dodatkowe żądania, które w przeciwnym razie byłyby konieczne.
- Pliki
.jssą wstawiane na końcu sekcji body - Pliki
.(s)csssą wstawiane na końcu sekcji head - Każdy plik jest wstawiany tylko raz
Wbudowane małe arkusze stylów
Domyślnie plik *.(s)css jest podłączany, co oznacza jedno żądanie na plik. Ustawienie assets.inlineLimit zamiast tego wstawia małe arkusze stylów bezpośrednio do strony, zgodnie z regułą stosowaną przez rdzeń WordPress dla własnych stylów: zewnętrzne arkusze stylów bloków na stronie są sortowane od najmniejszego do największego i wstawiane jako <style>, dopóki ich łączny rozmiar nie przekroczy limitu. Każdy pozostały plik zachowuje swój znacznik <link>.
{
"assets": {
"inlineLimit": 40000
}
}
Limit jest wyrażony w bajtach, a 0, czyli wartość domyślna, wyłącza to działanie. Mierzy on skompilowany plik, który załadowałby <link>, z minifikacją, jeśli włączono assets.minify.css. Rozmiar wpływa tylko na wybór między <link> a <style>. Każdy znacznik pozostaje w miejscu, w którym znalazłby się <link>, więc kolejność ładowania i kaskada pozostają bez zmian. Element zachowuje swoje id.
Ustawienie nie dotyczy plików *.inline.(s)css i *.scoped.(s)css, które są zawsze wstawiane bezpośrednio do strony, zasobów edytora i panelu administracyjnego ani arkuszy stylów wyodrębnionych z zaimportowanych modułów JavaScript. Globalne arkusze stylów są traktowane jak arkusze stylów bloków. Plik pozostaje podłączony, jeśli wstawienie go bezpośrednio do strony spowodowałoby jego zmianę:
- Zawiera względny URL w
url()lub@import, który przy podłączeniu jest rozwiązywany względem arkusza stylów, a po wstawieniu bezpośrednio do strony — względem strony. Ścieżki bezwzględne, pełne adresy URL, identyfikatory URIdata:i fragmenty#są dozwolone. - Używa
image-set()lub zawiera sekwencję zamykającą</style. - Zawiera sekwencje ucieczki CSS, otwierający komentarz HTML lub deklarację
@charset. Takie pliki pozostają podłączone, aby uniknąć ryzyka zmiany URL lub sposobu parsowania dokumentu.
Użyj filtra ustawienia, aby zmienić limit z PHP:
add_filter('blockstudio/settings/assets/inline_limit', fn() => 40000);
Wstawione bezpośrednio do strony CSS staje się częścią HTML strony. Po zmianie arkusza stylów trzeba wyczyścić pamięć podręczną strony, a przeglądarka nie może przechowywać tych bajtów w pamięci podręcznej między stronami. Dlatego limit jest łączny dla każdej strony.
Przypisane
Style przypisane do bloku są również wstawiane bezpośrednio, ale poprzedza je identyfikator unikalny dla każdego bloku. Użyj funkcji bs_get_scoped_class, aby dodać klasę do szablonu.
<section class="hero <?php echo bs_get_scoped_class($b['name']); ?>">
<h1 class="hero__title">Scope me!</h1>
</section>
%selector% {
--hero-gap: var(--wp--preset--spacing--space-10);
}
%selector%.hero {
border-bottom: 1px solid currentColor;
}
.hero__title {
color: red;
}
Powyższe ustawienie wygeneruje następujący styl przypisany do bloku:
<style>
.bs-62df71e6cc9a {
--hero-gap: var(--wp--preset--spacing--space-10);
}
.bs-62df71e6cc9a.hero {
border-bottom: 1px solid currentColor;
}
.bs-62df71e6cc9a .hero__title {
color: red;
}
</style>
<section class="hero bs-62df71e6cc9a">
<h1 class="hero__title">Scope me!</h1>
</section>
Zwykłe selektory w przypisanym pliku nadal wskazują elementy potomne elementu opakowującego. Użyj %selector%, jeśli chcesz stylizować sam element opakowujący.
Globalne
Oprócz zasobów przypisanych do bloków można też dodawać zasoby globalne, dostępne na wszystkich stronach, niezależnie od tego, czy znajduje się na nich blok. Aby dodać zasób globalny do kolejki, dodaj do nazwy pliku prefiks global-. Można go łączyć z dowolnym z przyrostków (e.g. -inline).
Dostępne kombinacje:
global-styles.(s)cssglobal-styles.inline.(s)cssglobal-styles.editor.(s)cssglobal-styles.scoped.(s)cssglobal-scripts.jsglobal-scripts.inline.jsglobal-scripts.editor.jsglobal-scripts.view.js
Administracja
Zasoby administracyjne są dodawane do kolejki tylko w obszarze administracyjnym WordPress. Do określenia zasobów administracyjnych służy prefiks admin-.
admin-styles.(s)cssadmin-scripts.js
Edytor bloków
Zasoby edytora bloków są dodawane do kolejki tylko w edytorze bloków. Do określenia tych zasobów służy prefiks block-editor-.
block-editor-styles.(s)cssblock-editor-scripts.js
Uwaga
Jeśli WordPress wyłącza ramkę edytora, ponieważ blok po stronie klienta jest zarejestrowany z wartością
apiVersionmniejszą niż 3, płótno edytora i elementy interfejsu administracyjnego WordPress współdzielą ten sam dokument. Skrypty globalne lub skrypty edytora obsługującewindow,document,body, zdarzenia kółka myszy lub przewijanie dokumentu powinny uwzględniaćbody.block-editor-pagelub wykluczać obszary edytora WordPress, takie jak.interface-complementary-areai.interface-navigable-region.
Kolejność ładowania
Na stronie, gdy automatyczne dodawanie zasobów do kolejki i buforowanie wyjścia są włączone,
Blockstudio dodaje blokowe znaczniki CSS <link> i <style> do buforowanej strony,
tuż przed zamykającym znacznikiem </head>, zamiast rejestrować je za pomocą
wp_enqueue_style(). Blokowe CSS trafiają więc za arkuszami stylów,
które WordPress wydrukowało już w sekcji head, w tym stylami motywu i wtyczek
dodanymi do kolejki za pomocą wp_enqueue_style(), niezależnie od ich priorytetu
lub zależności. Zasoby administracyjne i block-editor- korzystają zamiast tego
z systemu dodawania do kolejki WordPress.
Przy jednakowej ważności, warstwie kaskady i specyficzności arkusz stylów bloku ma pierwszeństwo przed arkuszem motywu. Aby to zmienić, zwiększ specyficzność reguły motywu albo dołącz arkusz motywu do sekcji head Blockstudio generowanej przez filtr blockstudio/render/head. Zawartość dodana przez filtr pojawia się za zasobami bloku. Usuń ten arkusz stylów z kolejki WordPress, aby nie został załadowany dwukrotnie.
add_action('wp_enqueue_scripts', function() {
wp_dequeue_style('theme-overrides');
}, 100);
add_filter('blockstudio/render/head', function($head) {
return $head . '<link rel="stylesheet" href="' . esc_url(get_theme_file_uri('overrides.css')) . '">';
});
Filtr head działa tylko wtedy, gdy Blockstudio buforuje stronę. Buforowanie jest wyłączone w podglądzie Personalizatora oraz gdy blockstudio/buffer/enabled zwraca false. bs_is_buffering() wskazuje, która sytuacja ma miejsce, dzięki czemu motyw może dodać arkusz stylów przez filtr, gdy strona jest buforowana, a w przeciwnym razie dodać go do kolejki za pomocą WordPress. Odpowiedź jest dostępna od wp_enqueue_scripts i ma wartość false przed template_redirect.
add_action('wp_enqueue_scripts', function() {
$url = get_theme_file_uri('overrides.css');
if (bs_is_buffering()) {
add_filter('blockstudio/render/head', function($head) use ($url) {
return $head . '<link rel="stylesheet" href="' . esc_url($url) . '">';
});
return;
}
wp_enqueue_style('theme-overrides', $url);
});
Użyj blockstudio/buffer/output, jeśli chcesz inaczej uporządkować dokument końcowy.
Wyłączanie dodawania do kolejki
Automatyczne dodawanie zasobów do kolejki można wyłączyć za pomocą ustawienia assets/enqueue. Przydaje się to, jeśli chcesz samodzielnie obsługiwać dodawanie wszystkich zasobów do kolejki.
add_filter('blockstudio/settings', function($settings) {
$settings['assets']['enqueue'] = false;
return $settings;
});
Dla każdego bloku
Jeśli szablon bloku nie zwraca niczego, Blockstudio nie doda do kolejki żadnych zasobów tego bloku. Ta metoda przydaje się do wyłączenia dodawania do kolejki po spełnieniu określonego warunku.
PHP
<?php
if ( !$a['slides'] ) {
// or return '';
return false;
}
?>
<div>my slider</div>
Twig
{% if not a.slides %}
<div>my slider</div>
{% endif %}