Înregistrarea resurselor
Blockstudio va adăuga automat în coadă toate fișierele care se termină în .css, .scss și .js când blocul este folosit pe o pagină. Puteți defini modul în care sunt adăugate resursele în coadă folosind unul dintre următoarele nume de fișiere. * este un metacaracter care poate fi înlocuit cu orice șir la alegere.
În fișierele CSS și SCSS ale blocului, %selector% se extinde la clasa wrapper cu scop limitat a blocului. Astfel puteți viza același element care primește bs_get_scoped_class(), chiar dacă fișierul nu este o resursă cu scop limitat.
| Model | Comportament |
|---|---|
*.(s)css |
Adaugă o etichetă <link> în editor și în interfața publică |
*.inline.(s)css |
Adaugă conținutul într-o etichetă <style> inline în editor și în interfața publică |
*.editor.(s)css |
Adaugă o etichetă <link> doar în editor |
*.scoped.(s)css |
Adaugă conținutul cu scop limitat într-o etichetă <style> inline în editor și în interfața publică |
*.js |
Adaugă o etichetă <script> în editor și în interfața publică |
*.inline.js |
Adaugă conținutul într-o etichetă <script> inline în editor și în interfața publică |
*.editor.js |
Adaugă o etichetă <script> doar în editor |
*.view.js |
Adaugă o etichetă <script> doar în interfața publică |
Notă
Notația cu cratimă (
*-inline.css,*-editor.cssetc.) este în continuare acceptată pentru compatibilitate cu versiunile anterioare, dar este depreciată. Folosiți notația cu punct pentru blocurile noi.
Inline
Stilurile și scripturile inline au avantajul major că sunt redate direct ca etichete style sau script în pagină. Acest lucru poate îmbunătăți timpii de încărcare, deoarece elimină solicitări suplimentare care altfel ar fi necesare.
- Fișierele
.jssunt incluse inline la sfârșitul body-ului - Fișierele
.(s)csssunt incluse inline la sfârșitul head-ului - Fiecare fișier este inclus inline o singură dată
Foi de stil mici inline
În mod implicit, un fișier *.(s)css este inclus printr-un link, ceea ce implică o cerere pentru fiecare fișier. Setarea assets.inlineLimit include în schimb foile de stil mici direct în pagină, urmând regula pe care WordPress o aplică propriilor stiluri: foile de stil externe ale blocurilor dintr-o pagină sunt ordonate de la cea mai mică la cea mai mare și incluse ca <style> cât timp totalul cumulativ rămâne sub limită. Pentru toate celelalte fișiere se păstrează eticheta <link>.
{
"assets": {
"inlineLimit": 40000
}
}
Limita este exprimată în octeți, iar valoarea 0, cea implicită, dezactivează acest comportament. Se măsoară fișierul compilat pe care l-ar încărca <link>, minificat dacă assets.minify.css este activată. Doar alegerea dintre <link> și <style> depinde de dimensiune. Fiecare etichetă rămâne în locul în care ar fi fost <link>, astfel încât ordinea de încărcare și cascada rămân neschimbate. Elementul își păstrează id.
Setarea nu se aplică fișierelor *.inline.(s)css și *.scoped.(s)css, care sunt întotdeauna inline, nici resurselor editorului și administratorului, nici foilor de stil extrase din modulele JavaScript importate. Foile de stil globale sunt luate în calcul la fel ca cele ale blocurilor. Un fișier rămâne inclus prin link ori de câte ori includerea lui inline l-ar modifica:
- Conține un URL relativ în
url()sau@import, care se rezolvă în raport cu foaia de stil când este inclus prin link și în raport cu pagina când este inline. Căile absolute, URL-urile complete, URI-uriledata:și fragmentele#sunt acceptate. - Folosește
image-set()sau conține o secvență de închidere</style. - Conține secvențe de escape CSS, un început de comentariu HTML sau o declarație
@charset. Din precauție, aceste fișiere rămân incluse prin link, pentru a evita modificarea URL sau interpretarea documentului.
Folosiți filtrul setării pentru a schimba limita din PHP:
add_filter('blockstudio/settings/assets/inline_limit', fn() => 40000);
CSS inclus inline devine parte din HTML paginii. După modificarea unei foi de stil, memoria cache a paginii trebuie golită, iar browserul nu poate păstra acei octeți în cache între pagini; de aceea limita este un total per pagină.
Cu scop limitat
Stilurile cu scop limitat sunt incluse și ele inline, dar au ca prefix un ID unic pentru fiecare bloc. Folosiți funcția bs_get_scoped_class pentru a adăuga clasa în șablon.
<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;
}
Cele de mai sus vor genera următorul stil cu scop limitat:
<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>
Selectorii obișnuiți dintr-un fișier cu scop limitat vizează în continuare descendenții wrapper-ului cu scop limitat. Folosiți %selector% când doriți să stilizați chiar wrapper-ul.
Global
Pe lângă resursele specifice blocurilor, puteți adăuga și resurse globale în coadă, care vor fi disponibile pe toate paginile, indiferent dacă este prezent un bloc. Pentru a adăuga o resursă globală în coadă, adăugați prefixul global- la numele fișierului. Oricare dintre sufixe (e.g. -inline) poate fi folosit în combinație.
Combinațiile posibile sunt:
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
Administrare
Resursele de administrare sunt adăugate în coadă doar în zona de administrare WordPress. Prefixul admin- este folosit pentru a defini resursele de administrare.
admin-styles.(s)cssadmin-scripts.js
Editor de blocuri
Resursele editorului de blocuri sunt adăugate în coadă doar în editorul de blocuri. Prefixul block-editor- este folosit pentru a le defini.
block-editor-styles.(s)cssblock-editor-scripts.js
Notă
Dacă WordPress dezactivează iframe-ul editorului deoarece un bloc de pe partea clientului este înregistrat cu
apiVersionmai mic decât 3, pânza editorului și elementele de interfață WordPress de administrare folosesc același document. Scripturile globale sau ale editorului care se leagă dewindow,document,body, evenimentele rotiței mouse-ului sau derularea documentului ar trebui să trateze corespunzătorbody.block-editor-pagesau să excludă zonele editorului WordPress, precum.interface-complementary-areași.interface-navigable-region.
Ordinea încărcării
În interfața publică, când adăugarea automată a resurselor în coadă și tamponarea ieșirii sunt activate, Blockstudio adaugă etichetele CSS, <link> și <style> ale blocului în pagina tamponată, chiar înainte de eticheta de închidere </head>, în loc să le înregistreze cu wp_enqueue_style(). Prin urmare, CSS blocului vine după foile de stil pe care WordPress le-a afișat deja în head, inclusiv stilurile temei și ale extensiilor adăugate în coadă cu wp_enqueue_style(), indiferent de prioritatea lor în coadă sau de dependențe. Resursele de administrare și block-editor- folosesc în schimb sistemul de adăugare în coadă al WordPress.
Pentru regulile cu aceeași importanță, același strat de cascadă și aceeași specificitate, foaia de stil a blocului are prioritate față de foaia de stil a temei. Pentru a schimba acest lucru, măriți specificitatea regulii temei sau adăugați foaia de stil a temei în head-ul Blockstudio pe care îl generează, folosind filtrul blockstudio/render/head. Conținutul adăugat prin filtru este plasat după resursele blocului. Scoateți foaia de stil și din WordPress, pentru a nu fi încărcată de două ori.
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')) . '">';
});
Filtrul head rulează doar când Blockstudio pune pagina în buffer. Bufferizarea este dezactivată în previzualizarea Customizerului și când blockstudio/buffer/enabled returnează false. bs_is_buffering() vă indică situația curentă, astfel încât o temă își poate adăuga foaia de stil prin filtru când pagina este pusă în buffer și o poate pune în coadă cu WordPress în caz contrar. Răspunsul este disponibil începând cu wp_enqueue_scripts și este false înainte de 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);
});
Folosiți blockstudio/buffer/output dacă trebuie să rearanjați documentul final într-un alt mod.
Dezactivarea adăugării în coadă
Adăugarea automată a resurselor în coadă poate fi dezactivată din setarea assets/enqueue. Acest lucru este util dacă doriți să gestionați singuri adăugarea tuturor resurselor în coadă.
add_filter('blockstudio/settings', function($settings) {
$settings['assets']['enqueue'] = false;
return $settings;
});
Per bloc
Când șablonul unui bloc nu returnează nimic, Blockstudio nu va adăuga resurse în coadă pentru blocul respectiv. Această metodă este utilă pentru a dezactiva adăugarea în coadă când este îndeplinită o anumită condiție.
PHP
<?php
if ( !$a['slides'] ) {
// or return '';
return false;
}
?>
<div>my slider</div>
Twig
{% if not a.slides %}
<div>my slider</div>
{% endif %}