Přejít k obsahu

Registrace prostředků

Blockstudio při použití bloku na stránce automaticky zařadí do fronty všechny soubory končící na .css, .scss a .js. Způsob zařazení prostředků do fronty můžete určit pomocí některého z následujících názvů souborů. Zástupný znak * můžete nahradit libovolným řetězcem.

V souborech bloku CSS a SCSS se %selector% rozbalí na třídu obalového prvku vymezenou pro daný blok. Můžete tak zacílit na stejný prvek, který dostává bs_get_scoped_class(), i když soubor není prostředkem vymezeným pro daný blok.

Vzor Chování
*.(s)css Zařadí tag <link> v editoru i na frontendu
*.inline.(s)css Zařadí obsah do vloženého tagu <style> v editoru i na frontendu
*.editor.(s)css Zařadí tag <link> pouze v editoru
*.scoped.(s)css Zařadí obsah vymezený pro blok do vloženého tagu <style> v editoru i na frontendu
*.js Zařadí tag <script> v editoru i na frontendu
*.inline.js Zařadí obsah do vloženého tagu <script> v editoru i na frontendu
*.editor.js Zařadí tag <script> pouze v editoru
*.view.js Zařadí tag <script> pouze na frontendu

Poznámka

Zápis s pomlčkou (*-inline.css, *-editor.css atd.) je kvůli zpětné kompatibilitě stále podporován, ale jeho používání se nedoporučuje. V nových blocích používejte zápis s tečkou.

Vložené prostředky

Vložené styly a skripty mají velkou výhodu: vykreslují se přímo na stránce jako tagy style nebo script. Tím se může stránka načítat rychleji, protože odpadá nutnost odesílat další požadavky.

  • Soubory .js se vkládají na konec těla dokumentu
  • Soubory .(s)css se vkládají na konec hlavičky dokumentu
  • Každý soubor se vloží pouze jednou

Vkládání malých stylopisů přímo do stránky

Soubor *.(s)css se standardně připojuje jako odkaz, což znamená jeden požadavek na každý soubor. Nastavení assets.inlineLimit místo toho vkládá malé stylopisy přímo do stránky podle pravidla, které WordPress používá pro vlastní styly: externí stylopisy bloků na stránce se seřadí od nejmenšího po největší a vypisují se jako <style>, dokud jejich průběžný součet nepřekročí limit. Každý další soubor si zachová svou značku <link>.

JSON
{
  "assets": {
    "inlineLimit": 40000
  }
}

Limit se udává v bajtech a hodnota 0, která je výchozí, toto chování vypíná. Měří se kompilovaný soubor, který by načetlo <link>, minifikovaný, pokud je zapnuto assets.minify.css. Na velikosti závisí pouze volba mezi <link> a <style>. Každá značka zůstává na místě, kde by bylo <link>, takže pořadí načítání i kaskáda zůstávají nezměněné. Element si zachovává své id.

Nastavení se nevztahuje na soubory *.inline.(s)css a *.scoped.(s)css, které jsou vždy vložené přímo, na prostředky editoru a administrace ani na stylopisy vytažené z importovaných modulů JavaScript. Globální stylopisy se počítají stejně jako stylopisy bloků. Soubor zůstane připojený jako odkaz, kdykoli by jeho vložení změnilo jeho obsah:

  • Obsahuje relativní URL v url() nebo @import, který se při připojení jako odkaz vyhodnocuje vzhledem ke stylopisu a při vložení přímo do stránky vzhledem ke stránce. Absolutní cesty, úplné URL, URI data: a fragmenty # jsou v pořádku.
  • Používá image-set() nebo obsahuje uzavírací sekvenci </style.
  • Obsahuje escape sekvence CSS, začátek komentáře HTML nebo deklaraci @charset. Tyto soubory zůstávají preventivně připojené jako odkazy, aby se předešlo změně URL nebo způsobu parsování dokumentu.

Pomocí filtru nastavení změňte limit z hodnoty PHP:

PHP
add_filter('blockstudio/settings/assets/inline_limit', fn() => 40000);

Vložené CSS se stává součástí HTML stránky. Po změně stylopisu je nutné vymazat mezipaměť stránky a prohlížeč nemůže tyto bajty ukládat do mezipaměti mezi stránkami, proto se limit vztahuje na součet za stránku.

Vymezené prostředky

Vymezené styly se také vkládají přímo do stránky, ale mají předponu s ID jedinečným pro každý blok. Funkcí bs_get_scoped_class přidejte třídu do své šablony.

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ýše uvedený postup vytvoří následující vymezený styl:

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>

Běžné selektory ve vymezeném souboru stále cílí na potomky vymezeného obalového prvku. Chcete-li stylovat samotný obalový prvek, použijte %selector%.

Globální prostředky

Kromě prostředků specifických pro blok můžete do fronty zařadit také globální prostředky, které budou dostupné na všech stránkách bez ohledu na to, zda se na nich blok nachází. Globální prostředek zařadíte do fronty přidáním předpony global- k názvu souboru. Lze použít kteroukoli z přípon (e.g, -inline).

Možné kombinace jsou:

  • 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

Administrace

Prostředky pro administraci se zařazují do fronty pouze v administrační části WordPress. Předpona admin- slouží k označení prostředků pro administraci.

  • admin-styles.(s)css
  • admin-scripts.js

Editor bloků

Prostředky editoru bloků se zařazují do fronty pouze v editoru bloků. Předpona block-editor- slouží k označení prostředků editoru bloků.

  • block-editor-styles.(s)css
  • block-editor-scripts.js

Poznámka

Pokud WordPress zakáže iframe editoru, protože je klientská strana bloku zaregistrována s apiVersion nižším než 3, plátno editoru a administrační rozhraní WordPress sdílejí stejný dokument. Globální skripty nebo skripty editoru, které reagují na window, document, body, události kolečka myši nebo posouvání dokumentu, by měly ošetřit body.block-editor-page nebo vyloučit oblasti editoru WordPress, například .interface-complementary-area a .interface-navigable-region.

Pořadí načítání

Na frontendu s automatickým zařazováním prostředků a povoleným ukládáním výstupu do vyrovnávací paměti přidá Blockstudio tagy CSS <link> a <style> bloku do stránky ve vyrovnávací paměti těsně před uzavírací tag </head>, místo aby je zaregistroval pomocí wp_enqueue_style(). CSS bloku se proto načte až po šablonách stylů, které WordPress již vypsal do hlavičky, včetně stylů šablony a pluginů zařazených do fronty pomocí wp_enqueue_style(), bez ohledu na jejich prioritu nebo závislosti. Prostředky administrace a block-editor- místo toho používají systém zařazování do fronty v WordPress.

U pravidel se stejnou důležitostí, vrstvou kaskády a specificitou má šablona stylů bloku přednost před šablonou stylů šablony webu. Chcete-li to změnit, zvyšte specificitu pravidla šablony, nebo přidejte šablonu stylů webu do hlavičky Blockstudio, kterou generuje, pomocí filtru blockstudio/render/head. Obsah přidaný filtrem se umístí za prostředky bloku. Šablonu stylů odeberte také z WordPress, aby se nenačetla 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')) . '">';
});

Filtr head se spouští pouze tehdy, když Blockstudio ukládá stránku do vyrovnávací paměti. Ve vyskakovacím náhledu editoru a při návratu hodnoty false z blockstudio/buffer/enabled je ukládání do vyrovnávací paměti vypnuté. bs_is_buffering() vám sdělí, který případ nastal, takže motiv může přes filtr přidat svůj stylopis, když se stránka ukládá do vyrovnávací paměti, a jinak jej zařadit do fronty pomocí WordPress. Tato informace je dostupná od wp_enqueue_scripts a je false před template_redirect.

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);
});

Pomocí blockstudio/buffer/output můžete v případě potřeby jinak upravit konečné pořadí prvků dokumentu.

Zakázání zařazování do fronty

Automatické zařazování prostředků do fronty lze vypnout pomocí nastavení assets/enqueue. Hodí se to, pokud chcete zařazování všech prostředků do fronty spravovat sami.

PHP
add_filter('blockstudio/settings', function($settings) {
  $settings['assets']['enqueue'] = false;
  return $settings;
});

Pro jednotlivý blok

Pokud šablona bloku vrátí prázdný výsledek, Blockstudio pro daný blok nezařadí do fronty žádné prostředky. Tento způsob se hodí, když chcete zařazování do fronty vypnout za určitých podmínek.

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 %}