Registracija sredstev
Blockstudio bo ob uporabi bloka na strani samodejno dodal v čakalno vrsto vse datoteke s končnicami .css, .scss in .js. Način dodajanja sredstev v čakalno vrsto lahko določite z enim od naslednjih imen datotek. * je nadomestni znak, ki ga lahko zamenjate s poljubnim nizom.
V datotekah CSS in SCSS bloka se %selector% razširi v ovojni razred, ki je določen za ta blok. Tako lahko izberete isti element, ki prejme bs_get_scoped_class(), tudi če datoteka ni sredstvo z določenim obsegom.
| Vzorec | Delovanje |
|---|---|
*.(s)css |
V urejevalniku in na vmesniku doda oznako <link> v čakalno vrsto |
*.inline.(s)css |
Vsebino doda v vrstično oznako <style> v čakalno vrsto v urejevalniku in na vmesniku |
*.editor.(s)css |
V urejevalniku doda oznako <link> v čakalno vrsto |
*.scoped.(s)css |
Vsebino z določenim obsegom doda v vrstično oznako <style> v čakalno vrsto v urejevalniku in na vmesniku |
*.js |
Na vmesniku in v urejevalniku doda oznako <script> v čakalno vrsto |
*.inline.js |
Vsebino doda v vrstično oznako <script> v čakalno vrsto v urejevalniku in na vmesniku |
*.editor.js |
V urejevalniku doda oznako <script> v čakalno vrsto |
*.view.js |
Samo na vmesniku doda oznako <script> v čakalno vrsto |
Opomba
Zapis z vezajem (
*-inline.css,*-editor.cssitd.) je zaradi združljivosti s starejšimi različicami še vedno podprt, vendar opuščen. Za nove bloke uporabite zapis s piko.
Vrstično
Vrstični slogi in skripti se izrišejo neposredno kot oznake sloga ali skripta na strani. To lahko pospeši nalaganje, saj prihrani dodatne zahteve, ki bi bile sicer potrebne.
- Datoteke
.jsso vstavljene na konec telesa - Datoteke
.(s)cssso vstavljene na konec glave - Vsaka datoteka je vstavljena samo enkrat
Vdelava majhnih slogovnih datotek
Datoteka *.(s)css je privzeto povezana, kar pomeni eno zahtevo na datoteko. Nastavitev assets.inlineLimit majhne slogovne datoteke izpiše neposredno v stran po pravilu, ki ga jedro WordPress uporablja za lastne sloge: zunanje slogovne datoteke blokov na strani razvrsti od najmanjše do največje in jih izpiše kot <style>, dokler njihova skupna velikost ne preseže omejitve. Vse druge datoteke ohranijo oznako <link>.
{
"assets": {
"inlineLimit": 40000
}
}
Omejitev je izražena v bajtih, vrednost 0, ki je privzeta, pa to vedenje izklopi. Meri prevedeno datoteko, ki bi jo naložil <link>, pomanjšano, kadar je vklopljen assets.minify.css. Od velikosti je odvisna samo izbira med <link> in <style>. Vsaka oznaka ostane tam, kjer bi bil <link>, zato se vrstni red nalaganja in kaskada ne spremenita. Element ohrani svoj id.
Nastavitev ne velja za datoteke *.inline.(s)css in *.scoped.(s)css, ki so vedno vdelane, za sredstva urejevalnika in skrbniškega vmesnika ali za slogovne datoteke, izluščene iz uvoženih modulov JavaScript. Globalne slogovne datoteke štejejo kot slogovne datoteke blokov. Datoteka ostane povezana, kadar bi vdelava spremenila njeno delovanje:
- V
url()ali@importvsebuje relativni URL, ki se pri povezani datoteki razreši glede na slogovno datoteko, pri vdelani pa glede na stran. Absolutne poti, polni URL-ji, URI-jidata:in fragmenti#so ustrezni. - Uporablja
image-set()ali vsebuje zaključno zaporedje</style. - Vsebuje ubežne znake CSS, začetni del komentarja HTML ali deklaracijo
@charset. Te datoteke zaradi varnosti ostanejo povezane, da ne bi tvegali sprememb URL ali razčlenjevanja dokumenta.
Za spremembo omejitve z PHP uporabite filter nastavitve:
add_filter('blockstudio/settings/assets/inline_limit', fn() => 40000);
Vdelani CSS postane del HTML strani. Po spremembi slogovne datoteke je treba izprazniti predpomnilnik strani, brskalnik pa teh bajtov ne more predpomniti za uporabo na več straneh, zato se omejitev nanaša na skupno velikost na posamezno stran.
Z določenim obsegom
Slogi z določenim obsegom so prav tako vstavljeni v vrstico, vendar imajo predpono z ID-jem, ki je enoličen za vsak blok. S funkcijo bs_get_scoped_class dodajte razred v predlogo.
<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;
}
Zgornje bo ustvarilo naslednji slog z določenim obsegom:
<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>
Običajni izbirniki v datoteki z določenim obsegom še vedno ciljajo na potomce ovojnega elementa. Če želite oblikovati sam ovojni element, uporabite %selector%.
Globalno
Poleg sredstev za posamezne bloke lahko v čakalno vrsto dodate tudi globalna sredstva, ki bodo na voljo na vseh straneh, ne glede na to, ali je na njih prisoten blok. Globalno sredstvo dodate tako, da imenu datoteke dodate predpono global-. Kombinirate lahko katero koli od končnic (e.g. -inline).
Možne kombinacije:
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
Skrbništvo
Skrbniška sredstva se dodajo v čakalno vrsto samo v skrbniškem območju WordPress. Za določanje skrbniških sredstev se uporablja predpona admin-.
admin-styles.(s)cssadmin-scripts.js
Urejevalnik blokov
Sredstva urejevalnika blokov se dodajo v čakalno vrsto samo v urejevalniku blokov. Za določanje sredstev urejevalnika blokov se uporablja predpona block-editor-.
block-editor-styles.(s)cssblock-editor-scripts.js
Opomba
Če WordPress onemogoči okvir urejevalnika, ker je blok na strani odjemalca registriran z
apiVersion, nižjo od 3, si platno urejevalnika in WordPress skrbniški okvir delita isti dokument. Globalni skripti ali skripti urejevalnika, ki se vežejo nawindow,document,body, dogodke kolesca ali drsenje dokumenta, morajo preveriti, ali gre zabody.block-editor-page, oziroma izključiti območja urejevalnika WordPress, kot sta.interface-complementary-areain.interface-navigable-region.
Vrstni red nalaganja
Na vmesniku, ko sta omogočena samodejno dodajanje sredstev v čakalno vrsto in medpomnjenje izhoda,
Blockstudio doda oznake blokov CSS <link> in <style> na stran v medpomnilniku
neposredno pred zaključno oznako </head>, namesto da bi jih registriral z
wp_enqueue_style(). Zato se blok CSS pojavi za slogovnimi datotekami, ki jih je
WordPress že izpisal v glavi, vključno s slogi tem in vtičnikov,
dodanimi v čakalno vrsto z wp_enqueue_style(), ne glede na njihovo prednost ali
odvisnosti. Skrbniška sredstva in sredstva block-editor- namesto tega uporabljajo
sistem za dodajanje v čakalno vrsto, ki ga zagotavlja WordPress.
Pri pravilih z enako pomembnostjo, plastjo kaskade in specifičnostjo ima slogovna datoteka bloka prednost pred slogovno datoteko teme. To spremenite tako, da povečate specifičnost pravila teme ali slogovno datoteko teme dodate v glavo Blockstudio z uporabo filtra blockstudio/render/head. Vsebina, dodana s filtrom, se postavi za sredstva bloka. Slogovno datoteko odstranite iz čakalne vrste tudi z WordPress, da se ne naloži dvakrat.
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 se zažene samo, ko Blockstudio shrani stran v medpomnilnik. Medpomnjenje je izklopljeno v predogledu orodja za prilagajanje in kadar blockstudio/buffer/enabled vrne false. bs_is_buffering() pove, za kateri primer gre, zato lahko tema prek filtra doda svojo slogovno datoteko, kadar je stran v medpomnilniku, v nasprotnem primeru pa jo doda v čakalno vrsto z WordPress. Odgovor je na voljo od wp_enqueue_scripts naprej in je false pred template_redirect.
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);
});
Uporabite blockstudio/buffer/output, če želite končni dokument preurediti drugače.
Onemogočanje dodajanja v čakalno vrsto
Samodejno dodajanje sredstev v čakalno vrsto lahko onemogočite z nastavitvijo assets/enqueue. To je uporabno, če želite sami upravljati dodajanje vseh sredstev v čakalno vrsto.
add_filter('blockstudio/settings', function($settings) {
$settings['assets']['enqueue'] = false;
return $settings;
});
Za posamezni blok
Če predloga bloka vrne prazno vrednost, Blockstudio za ta blok ne bo dodal nobenega sredstva v čakalno vrsto. Ta način je priročen za onemogočanje dodajanja v čakalno vrsto, ko je izpolnjen določen pogoj.
PHP
<?php
if ( !$a['slides'] ) {
// or return '';
return false;
}
?>
<div>my slider</div>
Twig
{% if not a.slides %}
<div>my slider</div>
{% endif %}