Preskočiť na obsah

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.css atď.) 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 .js sa vkladajú na koniec tela dokumentu
  • Súbory .(s)css sa 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>.

JSON
{
  "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, URI data: 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:

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.

PHP
<section class="hero <?php echo bs_get_scoped_class($b['name']); ?>">
  <h1 class="hero__title">Scope me!</h1>
</section>
CSS
%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:

HTML
<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)css
  • global-styles.inline.(s)css
  • global-styles.editor.(s)css
  • global-styles.scoped.(s)css
  • global-scripts.js
  • global-scripts.inline.js
  • global-scripts.editor.js
  • global-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)css
  • admin-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)css
  • block-editor-scripts.js

Poznámka

Ak WordPress vypne iframe editora, pretože je zaregistrovaný blok na strane klienta s hodnotou apiVersion nižšou ako 3, plátno editora a administratívne rozhranie WordPress zdieľajú ten istý dokument. Globálne skripty alebo skripty editora, ktoré reagujú na window, document, body, udalosti kolieska myši alebo posúvanie dokumentu, by mali ošetriť prípad body.block-editor-page alebo vylúčiť oblasti editora WordPress, napríklad .interface-complementary-area a .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.

PHP
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.

PHP
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.

PHP
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
<?php
  if ( !$a['slides'] ) {
    // or return '';
    return false;
  }
?>

<div>my slider</div>

Twig

Twig
{% if not a.slides %}
  <div>my slider</div>
{% endif %}