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.cssstb.) 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
.jsfájlok a törzsrész végére kerülnek beágyazásra - A
.(s)cssfá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.
{
"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@importformá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ó</stylesorozatot tartalmaz.- CSS escape-szekvenciákat tartalmaz, HTML megjegyzésnyitót vagy
@charsetdeklará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
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.
<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;
}
A fenti eredménye a következő, hatókörhöz kötött stílus lesz:
<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)cssglobal-styles.inline.(s)cssglobal-styles.editor.(s)cssglobal-styles.scoped.(s)cssglobal-scripts.jsglobal-scripts.inline.jsglobal-scripts.editor.jsglobal-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)cssadmin-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)cssblock-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. Awindow,document,bodyeseményekhez, az egéreseményekhez vagy a dokumentum görgetéséhez kötött globális vagy szerkesztői szkriptekben kezelje azbody.block-editor-pageesetét, vagy zárja ki az olyan szerkesztői területeket, mint a.interface-complementary-areaés a.interface-navigable-regionWordPress.
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.
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.
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.
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
if ( !$a['slides'] ) {
// or return '';
return false;
}
?>
<div>my slider</div>
Twig
{% if not a.slides %}
<div>my slider</div>
{% endif %}