Ugrás a tartalomhoz

Eszközök regisztrálása

A Blockstudio automatikusan betölti a .css, .scss és .js végű fájlokat, amikor a blokkot használják egy oldalon. Az eszközök betöltésének módját a következő fájlnevek egyikével határozhatja meg. A * helyettesítő karakter, amely tetszőleges szövegre cserélhető.

A blokk CSS és SCSS fájljaiban a %selector% a blokk hatókörére jellemző burkolóosztályra bővül. Így ugyanazt az elemet célozhatja meg, amely a bs_get_scoped_class() értéket kapja, akkor is, ha a fájl nem hatókörhöz kötött eszköz.

Minta Működés
*.(s)css <link> címkeként töltődik be a szerkesztőben és a kezelőfelületen
*.inline.(s)css A tartalom inline <style> címkeként töltődik be a szerkesztőben és a kezelőfelületen
*.editor.(s)css <link> címkeként töltődik be, csak a szerkesztőben
*.scoped.(s)css A hatókörhöz kötött tartalom inline <style> címkeként töltődik be a szerkesztőben és a kezelőfelületen
*.js <script> címkeként töltődik be a szerkesztőben és a kezelőfelületen
*.inline.js A tartalom inline <script> címkeként töltődik be a szerkesztőben és a kezelőfelületen
*.editor.js <script> címkeként töltődik be, csak a szerkesztőben
*.view.js <script> címkeként töltődik be, csak a kezelőfelületen

Megjegyzés

A kötőjeles jelölés (*-inline.css, *-editor.css stb.) továbbra is támogatott a visszamenőleges kompatibilitás érdekében, de elavultnak számít. Új blokkoknál pontozott jelölést használjon.

Beágyazás

Az inline stílusok és szkriptek nagy előnye, hogy közvetlenül stílus- vagy szkriptcímkeként jelennek meg az oldalon. Ez felgyorsíthatja a betöltést, mivel nincs szükség az egyébként szükséges további kérésekre.

  • A .js fájlok a törzsrész végére kerülnek beágyazásra
  • A .(s)css fájlok a fejlécrész végére kerülnek beágyazásra
  • Minden fájl csak egyszer kerül beágyazásra

Kis stíluslapok beágyazása

Alapértelmezés szerint a *.(s)css fájl hivatkozással kerül be, ami fájlonként egy kérést jelent. A assets.inlineLimit beállítás ehelyett beágyazva írja ki a kis stíluslapokat, a WordPress által a saját stílusaira alkalmazott szabályt követve: egy oldal külső blokkstíluslapjai a legkisebbtől a legnagyobbig kerülnek kiválasztásra és <style> formájában kiírásra, amíg az összméretük a korláton belül marad. Minden más fájl megőrzi a <link> címkéjét.

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

A korlát bájtban értendő, és 0 az alapértelmezett érték, amely kikapcsolja ezt a működést. A lefordított fájl méretét veszi alapul, amelyet a <link> töltene be; ez tömörített, ha a assets.minify.css be van kapcsolva. Csak az <link> és az <style> közötti választás függ a mérettől. Minden címke ott marad, ahol a <link> lett volna, így a betöltési sorrend és a kaszkád változatlan marad. Az elem megtartja a id értékét.

A beállítás nem vonatkozik a *.inline.(s)css és *.scoped.(s)css fájlokra, amelyek mindig beágyazva szerepelnek, sem a szerkesztői és adminisztrációs eszközökre, sem az importált JavaScript modulokból kinyert stíluslapokra. A globális stíluslapok ugyanúgy beleszámítanak, mint a blokkstíluslapok. A fájl hivatkozásként marad meg, ha a beágyazás megváltoztatná:

  • Relatív URL értéket tartalmaz url() vagy @import formájában; ez hivatkozásként a stíluslaphoz, beágyazáskor pedig az oldalhoz viszonyítva oldódik fel. Az abszolút útvonalak, teljes URL-ek, data: URI-k és # töredékek rendben vannak.
  • image-set() elemet használ, vagy záró </style sorozatot tartalmaz.
  • CSS escape-szekvenciákat tartalmaz, HTML megjegyzésnyitót vagy @charset deklarációt tartalmaz. Ezek a fájlok elővigyázatosságból hivatkozásként maradnak meg, így elkerülhető a URL megváltozása vagy a dokumentum hibás feldolgozása.

A beállításszűrővel módosíthatja a korlátot erről az értékről: PHP

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

A beágyazott CSS az oldal HTML részévé válik. A stíluslap módosítása után ki kell üríteni az oldal gyorsítótárát, és a böngésző nem tudja ezeket a bájtokat az oldalak között gyorsítótárazni; ezért a korlát oldalankénti összértékre vonatkozik.

Hatókörhöz kötött

A hatókörhöz kötött stílusok szintén beágyazódnak, de minden blokkhoz egyedi azonosítóval kapnak előtagot. A bs_get_scoped_class függvénnyel adhatja hozzá az osztályt a sablonhoz.

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

A fenti eredménye a következő, hatókörhöz kötött stílus lesz:

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>

A hatókörhöz kötött fájlban lévő hagyományos szelektorok továbbra is a hatókör burkolóelemének leszármazottait célozzák. Ha magát a burkolóelemet szeretné formázni, használja a %selector% elemet.

Globális

A blokkspecifikus eszközök mellett globális eszközök is betölthetők, amelyek minden oldalon elérhetők, függetlenül attól, hogy szerepel-e rajta blokk. Globális eszköz betöltéséhez adja a global- előtagot a fájlnévhez. Bármelyik utótag (e.g, -inline) használható ezek kombinációjával.

Lehetséges kombinációk:

  • 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

Adminisztráció

Az adminisztrációs eszközök csak az WordPress adminisztrációs területen töltődnek be. Az adminisztrációs eszközök megadásához a admin- előtagot kell használni.

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

Blokkszerkesztő

A blokkszerkesztő eszközei csak a blokkszerkesztőben töltődnek be. A blokkszerkesztő eszközeinek megadásához a block-editor- előtagot kell használni.

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

Megjegyzés

Ha a WordPress letiltja a szerkesztő iframe-jét, mert egy kliensoldali blokkot 3-nál kisebb apiVersion értékkel regisztráltak, a szerkesztő vászna és az WordPress adminisztrációs felület ugyanazt a dokumentumot használja. A window, document, body eseményekhez, az egéreseményekhez vagy a dokumentum görgetéséhez kötött globális vagy szerkesztői szkriptekben kezelje az body.block-editor-page esetét, vagy zárja ki az olyan szerkesztői területeket, mint a .interface-complementary-area és a .interface-navigable-region WordPress.

Betöltési sorrend

A kezelőfelületen, ha az automatikus eszközbetöltés és a kimeneti pufferelés engedélyezett, a Blockstudio a pufferelt oldalhoz közvetlenül a záró </head> címke előtt adja hozzá a blokk CSS <link> és <style> címkéit, ahelyett hogy regisztrálná őket a wp_enqueue_style() segítségével. A blokk CSS stíluslapjai ezért a WordPress által már a fejlécben kiírt stíluslapok után kerülnek be, beleértve a wp_enqueue_style() segítségével betöltött téma- és bővítménystílusokat is, azok betöltési prioritásától és függőségeitől függetlenül. Az adminisztrációs és block-editor- eszközök ehelyett a WordPress betöltési rendszerét használják.

Azonos fontosság, lépcsőréteg és specifikusság esetén a blokk stíluslapja felülírja a téma stíluslapját. Ennek módosításához növelje a témaszabály specifikusságát, vagy fűzze hozzá a téma stíluslapját a fejléc HTML-részéhez, amelyet a Blockstudio hoz létre a blockstudio/render/head szűrővel. A szűrő által hozzáadott tartalom a blokk eszközei után kerül be. Távolítsa el a stíluslapot a WordPress segítségével is, hogy ne töltődjön be kétszer.

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')) . '">';
});

A head szűrő csak akkor fut le, amikor a Blockstudio puffereli az oldalt. A pufferelés ki van kapcsolva a Testreszabó előnézetében, valamint akkor, amikor a blockstudio/buffer/enabled értéke false. A bs_is_buffering() jelzi, hogy melyik esetről van szó, így a sablon a szűrőn keresztül fűzheti hozzá a stíluslapját, amikor az oldal pufferelése aktív, egyébként pedig betöltheti a WordPress segítségével. Az eredmény a wp_enqueue_scripts időpontjától érhető el, és template_redirect előtt 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);
});

Ha másképp szeretné átrendezni a végleges dokumentumot, használja a blockstudio/buffer/output lehetőséget.

Betöltés letiltása

Az automatikus eszközbetöltés a assets/enqueue beállítással tiltható le. Ez akkor hasznos, ha az összes eszköz betöltését saját maga szeretné kezelni.

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

Blokkonként

Ha egy blokk sablonja semmit sem ad vissza, a Blockstudio nem tölt be eszközöket az adott blokkhoz. Ez jól használható a betöltés letiltására bizonyos feltételek teljesülésekor.

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