Registrácia zdrojov
Blockstudio automaticky zaradí do frontu všetky súbory končiace na .css, .scss a .js, keď sa váš blok používa na stránke. Spôsob zaraďovania zdrojových súborov do frontu možno určiť pomocou niektorého z nasledujúcich názvov súborov. * je zástupný znak, ktorý možno nahradiť ľubovoľným reťazcom.
V súboroch bloku CSS a SCSS sa %selector% nahradí triedou obalového prvku konkrétneho bloku. Vďaka tomu môžete zacieliť na rovnaký prvok, ktorému sa priradí bs_get_scoped_class(), aj keď súbor nepatrí medzi súbory s obmedzeným rozsahom.
| Vzor | Správanie |
|---|---|
*.(s)css |
Zaraďuje ako značku <link> v editore aj na frontende |
*.inline.(s)css |
Zaraďuje obsah do vloženej značky <style> v editore aj na frontende |
*.editor.(s)css |
Zaraďuje ako značku <link> iba v editore |
*.scoped.(s)css |
Zaraďuje obsah s obmedzeným rozsahom do vloženej značky <style> v editore aj na frontende |
*.js |
Zaraďuje ako značku <script> v editore aj na frontende |
*.inline.js |
Zaraďuje obsah do vloženej značky <script> v editore aj na frontende |
*.editor.js |
Zaraďuje ako značku <script> iba v editore |
*.view.js |
Zaraďuje ako značku <script> iba na frontende |
Poznámka
Zápis s pomlčkou (
*-inline.css,*-editor.cssatď.) sa z dôvodu spätnej kompatibility stále podporuje, ale je zastaraný. V nových blokoch používajte zápis s bodkou.
Vložené
Vložené štýly a skripty majú veľkú výhodu: vykresľujú sa priamo na stránke ako značky štýlu alebo skriptu. Môže to urýchliť načítanie, pretože sa ušetria dodatočné požiadavky, ktoré by inak bolo potrebné odoslať.
- Súbory
.jssa vkladajú na koniec tela dokumentu - Súbory
.(s)csssa vkladajú na koniec hlavičky dokumentu - Každý súbor sa vloží iba raz
Vkladanie malých šablón štýlov
Súbor *.(s)css sa predvolene pripája ako odkaz, čo znamená jednu požiadavku na každý súbor. Nastavenie assets.inlineLimit namiesto toho vkladá malé šablóny štýlov priamo do stránky podľa pravidla, ktoré WordPress používa pre vlastné štýly: externé šablóny štýlov blokov na stránke sa zoradia od najmenšej po najväčšiu a vkladajú sa ako <style>, kým ich priebežná celková veľkosť neprekročí limit. Každý ďalší súbor si ponechá značku <link>.
{
"assets": {
"inlineLimit": 40000
}
}
Limit sa udáva v bajtoch a hodnota 0, ktorá je predvolená, toto správanie vypína. Meria skompilovaný súbor, ktorý by načítalo <link>, v minifikovanej podobe, keď je zapnuté assets.minify.css. Od veľkosti závisí iba voľba medzi <link> a <style>. Každá značka zostáva na mieste, kde by bolo <link>, takže poradie načítania aj kaskáda zostávajú nezmenené. Prvok si zachová svoje id.
Nastavenie sa nevzťahuje na súbory *.inline.(s)css a *.scoped.(s)css, ktoré sú vždy vložené priamo, ani na zdroje editora a administrácie či na šablóny štýlov extrahované z importovaných modulov JavaScript. Globálne šablóny štýlov sa počítajú ako šablóny štýlov blokov. Súbor zostane pripojený ako odkaz vždy, keď by jeho vloženie zmenilo:
- Obsahuje relatívnu URL v
url()alebo@import, ktorá sa pri pripojení ako odkaz vyrieši vzhľadom na šablónu štýlov a pri vložení vzhľadom na stránku. Absolútne cesty, úplné adresy URL, URIdata:a fragmenty#sú v poriadku. - Používa
image-set()alebo obsahuje uzatváraciu sekvenciu</style. - Obsahuje escape sekvencie CSS, úvodnú značku komentára HTML alebo deklaráciu
@charset. Takéto súbory zostanú z opatrnosti pripojené ako odkazy, aby sa predišlo zmene URL alebo nesprávnemu parsovaniu dokumentu.
Pomocou filtra nastavenia zmeňte limit z hodnoty PHP:
add_filter('blockstudio/settings/assets/inline_limit', fn() => 40000);
Vložené CSS sa stane súčasťou HTML stránky. Po zmene šablóny štýlov treba vyprázdniť vyrovnávaciu pamäť stránky a prehliadač nemôže tieto bajty ukladať do vyrovnávacej pamäte medzi stránkami, preto je limitom celková veľkosť na stránku.
S obmedzeným rozsahom
Štýly s obmedzeným rozsahom sa tiež vkladajú priamo do stránky, ale ich predponou je ID jedinečné pre každý blok. Na pridanie tejto triedy do šablóny použite funkciu bs_get_scoped_class.
<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;
}
Výsledkom vyššie uvedeného bude nasledujúci štýl s obmedzeným rozsahom:
<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>
Bežné selektory v súbore s obmedzeným rozsahom stále cielia na potomkov obalového prvku s obmedzeným rozsahom. Ak chcete upraviť štýl samotného obalového prvku, použite %selector%.
Globálne
Okrem zdrojových súborov pre konkrétne bloky možno do frontu zaradiť aj globálne zdrojové súbory, ktoré budú dostupné na všetkých stránkach bez ohľadu na to, či sa na nich nachádza blok. Globálny zdrojový súbor zaradíte do frontu pridaním predpony global- k názvu súboru. Možno použiť ľubovoľnú kombináciu prípon (e.g. -inline).
Možné kombinácie:
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
Administrácia
Zdroje pre správu sa zaraďujú do frontu iba v administrátorskej oblasti WordPress. Predpona admin- slúži na určenie zdrojov pre správu.
admin-styles.(s)cssadmin-scripts.js
Editor blokov
Zdroje editora blokov sa zaraďujú do frontu iba v editore blokov. Predpona block-editor- slúži na určenie zdrojov editora blokov.
block-editor-styles.(s)cssblock-editor-scripts.js
Poznámka
Ak WordPress vypne iframe editora, pretože je zaregistrovaný blok na strane klienta s hodnotou
apiVersionnižšou ako 3, plátno editora a administratívne rozhranie WordPress zdieľajú ten istý dokument. Globálne skripty alebo skripty editora, ktoré reagujú nawindow,document,body, udalosti kolieska myši alebo posúvanie dokumentu, by mali ošetriť prípadbody.block-editor-pagealebo vylúčiť oblasti editora WordPress, napríklad.interface-complementary-areaa.interface-navigable-region.
Poradie načítania
Na frontende pri zapnutom automatickom zaraďovaní zdrojových súborov do frontu a ukladaní výstupu do vyrovnávacej pamäte pridá Blockstudio značky bloku CSS <link> a <style> do uloženej stránky tesne pred uzatváraciu značku </head> namiesto ich registrácie pomocou wp_enqueue_style(). Skript bloku CSS sa preto načíta až po štýloch, ktoré WordPress už vypísal v hlavičke vrátane štýlov témy a pluginu zaradených do frontu pomocou wp_enqueue_style(), bez ohľadu na prioritu ich zaradenia alebo závislosti. Zdroje pre správu a block-editor- sa namiesto toho zaraďujú do frontu pomocou systému zaraďovania WordPress.
Ak majú pravidlá rovnakú dôležitosť, vrstvu kaskády a špecificitu, štýl bloku má prednosť pred štýlom témy. Ak to chcete zmeniť, buď zvýšte špecificitu pravidla témy, alebo pridajte štýl témy do hlavičky Blockstudio, ktorú generuje filter blockstudio/render/head. Obsah pridaný filtrom sa umiestni za zdrojové súbory bloku. Štýl odstráňte z frontu aj pomocou WordPress, aby sa nenačítal dvakrát.
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')) . '">';
});
Filter head sa spustí iba vtedy, keď Blockstudio ukladá stránku do vyrovnávacej pamäte. Ukladanie je vypnuté v náhľade Customizeru a keď blockstudio/buffer/enabled vracia hodnotu false. bs_is_buffering() vám oznámi, ktorý prípad nastal, takže téma môže cez filter pridať svoju šablónu štýlov, keď sa stránka ukladá do vyrovnávacej pamäte, a inak ju zaradiť do frontu pomocou WordPress. Odpoveď je dostupná od wp_enqueue_scripts a pred template_redirect má hodnotu false.
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);
});
Ak potrebujete inak usporiadať výsledný dokument, použite blockstudio/buffer/output.
Vypnutie zaraďovania do frontu
Automatické zaraďovanie zdrojových súborov do frontu možno vypnúť pomocou nastavenia assets/enqueue. Hodí sa to, ak chcete všetky zdrojové súbory zaraďovať do frontu sami.
add_filter('blockstudio/settings', function($settings) {
$settings['assets']['enqueue'] = false;
return $settings;
});
Pre každý blok
Ak šablóna bloku nič nevráti, Blockstudio nezaradí do frontu žiadne zdroje pre daný blok. Tento spôsob sa hodí na vypnutie zaraďovania do frontu pri splnení určitej podmienky.
PHP
<?php
if ( !$a['slides'] ) {
// or return '';
return false;
}
?>
<div>my slider</div>
Twig
{% if not a.slides %}
<div>my slider</div>
{% endif %}