Išteklių registravimas
Blockstudio automatiškai į eilę įtrauks visus failus, kurių pavadinimai baigiasi .css, .scss ir .js, kai jūsų blokas naudojamas puslapyje. Į eilę įtraukiamų išteklių elgseną galima apibrėžti naudojant vieną iš toliau nurodytų failų pavadinimų. * yra pakaitos simbolis, kurį galite pakeisti bet kokia pasirinkta eilute.
Bloko CSS ir SCSS failuose %selector% išplečiamas į bloko apimties apvalkalo klasę. Taip galima taikyti stilių tam pačiam elementui, kuris gauna bs_get_scoped_class(), net jei failas nėra aprėpties išteklius.
| Šablonas | Elgsena |
|---|---|
*.(s)css |
Įtraukia kaip žymą <link> redaktoriuje ir svetainės sąsajoje |
*.inline.(s)css |
Įtraukia turinį į įterptąją žymą <style> redaktoriuje ir svetainės sąsajoje |
*.editor.(s)css |
Įtraukia kaip žymą <link> tik redaktoriuje |
*.scoped.(s)css |
Įtraukia aprėpties turinį į įterptąją žymą <style> redaktoriuje ir svetainės sąsajoje |
*.js |
Įtraukia kaip žymą <script> redaktoriuje ir svetainės sąsajoje |
*.inline.js |
Įtraukia turinį į įterptąją žymą <script> redaktoriuje ir svetainės sąsajoje |
*.editor.js |
Įtraukia kaip žymą <script> tik redaktoriuje |
*.view.js |
Įtraukia kaip žymą <script> tik svetainės sąsajoje |
Pastaba
Brūkšninė notacija (
*-inline.css,*-editor.cssir kt.) vis dar palaikoma dėl atgalinio suderinamumo, tačiau laikoma pasenusia. Naujiems blokams naudokite taškinę notaciją.
Įterptasis turinys
Įterptieji stiliai ir scenarijai turi didelį pranašumą: jie tiesiogiai įterpiami į puslapį kaip stiliaus arba scenarijaus žymos. Tai gali pagreitinti įkėlimą, nes nebereikia siųsti papildomų užklausų.
.jsfailai įterpiami dokumento body pabaigoje.(s)cssfailai įterpiami dokumento head pabaigoje- Kiekvienas failas įterpiamas tik vieną kartą
Mažų stilių lentelių įterpimas
Pagal numatytuosius nustatymus *.(s)css failas susiejamas, todėl kiekvienam failui tenka viena užklausa. Nustačius assets.inlineLimit, mažos stilių lentelės įterpiamos tiesiai į puslapį pagal taisyklę, kurią WordPress branduolys taiko savo stiliams: puslapio išorinės blokų stilių lentelės imamos nuo mažiausios iki didžiausios ir įterpiamos kaip <style>, kol jų bendra apimtis neviršija ribos. Visų kitų failų <link> žyma paliekama.
{
"assets": {
"inlineLimit": 40000
}
}
Riba nurodoma baitais, o 0, numatytoji reikšmė, šią funkciją išjungia. Matuojamas kompiliuotas failas, kurį įkeltų <link>, o kai assets.minify.css įjungta – jo minifikuota versija. Nuo dydžio priklauso tik tai, ar naudojama <link>, ar <style>. Kiekviena žyma lieka ten, kur būtų buvusi <link>, todėl įkėlimo tvarka ir kaskada nepakinta. Elementas išsaugo savo id.
Šis nustatymas netaikomas failams *.inline.(s)css ir *.scoped.(s)css, kurie visada įterpiami tiesiai į puslapį, redaktoriaus ir administravimo ištekliams ar stilių lentelėms, išskirtoms iš importuotų JavaScript modulių. Visuotinės stilių lentelės skaičiuojamos kaip blokų stilių lentelės. Failas paliekamas susietas, jei jį įterpus tiesiai į puslapį pasikeistų:
- Jame yra santykinis URL, esantis
url()arba@import. Kai failas susietas, kelias nustatomas pagal stilių lentelę, o įterpus tiesiai į puslapį – pagal patį puslapį. Absoliutūs keliai, pilni URL adresai,data:URI ir#fragmentai tinka. - Jame naudojamas
image-set()arba yra uždarymo seka</style. - Jame yra CSS pabėgimo sekų, komentaro pradžios žymuo HTML arba deklaracija
@charset. Siekiant išvengti pakitusio URL arba dokumento analizavimo, tokie failai atsargumo sumetimais paliekami susieti.
Norėdami pakeisti ribą, naudokite nustatymo filtrą; numatytoji reikšmė yra PHP:
add_filter('blockstudio/settings/assets/inline_limit', fn() => 40000);
Įterptas CSS tampa puslapio HTML dalimi. Pakeitus stilių lentelę reikia išvalyti puslapio podėlį, o naršyklė negali podėlyje išsaugoti šių baitų ir panaudoti jų kituose puslapiuose, todėl nustatoma bendra riba kiekvienam puslapiui.
Aprėptis
Aprėpties stiliai taip pat įterpiami, tačiau jiems suteikiamas kiekvienam blokui unikalus ID kaip priešdėlis. Naudokite funkciją bs_get_scoped_class, kad pridėtumėte klasę prie šablono.
<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;
}
Aukščiau pateiktas kodas sukurs tokį aprėpties stilių:
<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>
Aprėpties faile esantys įprasti selektoriai vis tiek taikomi aprėpties apvalkalo elementų palikuonims. Norėdami formatuoti patį apvalkalą, naudokite %selector%.
Visuotiniai ištekliai
Be konkretaus bloko išteklių, galima į eilę įtraukti ir visuotinius išteklius, kurie bus pasiekiami visuose puslapiuose, net jei juose nėra jokio bloko. Norėdami įtraukti visuotinį išteklių į eilę, prie failo pavadinimo pridėkite priešdėlį global-. Galima naudoti bet kurį priesagų derinį (e.g. -inline).
Galimi deriniai:
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
Administravimas
Administravimo ištekliai į eilę įtraukiami tik WordPress administravimo srityje. Administravimo ištekliams apibrėžti naudojamas priešdėlis admin-.
admin-styles.(s)cssadmin-scripts.js
Blokų redaktorius
Blokų redaktoriaus ištekliai į eilę įtraukiami tik blokų redaktoriuje. Blokų redaktoriaus ištekliams apibrėžti naudojamas priešdėlis block-editor-.
block-editor-styles.(s)cssblock-editor-scripts.js
Pastaba
Jei WordPress išjungia redaktoriaus iframe, nes kliento pusėje registruotas blokas su
apiVersionmažesniu nei 3, redaktoriaus drobė ir WordPress administravimo sąsajos elementai naudoja tą patį dokumentą. Visuotiniai arba redaktoriaus scenarijai, kurie susiejami suwindow,document,body, ratuko įvykiais arba dokumento slinkimu, turėtų patikrinti, ar įvykis kilo dėlbody.block-editor-page, arba neįtraukti WordPress redaktoriaus sričių, pavyzdžiui,.interface-complementary-areair.interface-navigable-region.
Įkėlimo tvarka
Svetainės sąsajoje, kai įjungtas automatinis išteklių įtraukimas į eilę ir išvesties buferizavimas, Blockstudio į buferizuojamą puslapį įterpia bloko CSS <link> ir <style> žymas prieš pat uždarymo žymą </head>, užuot jas registravęs per wp_enqueue_style(). Todėl bloko CSS įkeliamas po stilių lentelių, kurias WordPress jau įterpė į antraštę, įskaitant temų ir įskiepių stilius, įtrauktus į eilę naudojant wp_enqueue_style(), neatsižvelgiant į jų įtraukimo į eilę prioritetą ar priklausomybes. Administravimo ir block-editor- ištekliai naudoja įtraukimo į eilę sistemą WordPress.
Esant vienodam svarbos lygiui, kaskados sluoksniui ir specifiškumui, bloko stilių lentelė turi pirmenybę prieš temos stilių lentelę. Norėdami pakeisti šią tvarką, padidinkite temos taisyklės specifiškumą arba pridėkite temos stilių lentelę į head, kurį generuoja Blockstudio, naudodami filtrą blockstudio/render/head. Filtru pridėtas turinys pateikiamas po bloko išteklių. Taip pat pašalinkite stilių lentelę iš WordPress eilės, kad ji nebūtų įkeliama du kartus.
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')) . '">';
});
Filtras head veikia tik tada, kai Blockstudio buferizuoja puslapį. Peržiūrint „Customizer“ puslapio buferizavimas išjungtas, taip pat jis išjungtas, kai blockstudio/buffer/enabled sąsaja grąžina false.
bs_is_buffering() nurodo, kuris atvejis taikomas, todėl tema gali per filtrą pridėti stilių lentelę, kai puslapis buferizuojamas, o kitu atveju įtraukti ją į eilę naudodama WordPress. Atsakymą galima gauti nuo wp_enqueue_scripts ir jis yra false prieš 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);
});
Jei reikia kitaip pertvarkyti galutinį dokumentą, naudokite blockstudio/buffer/output.
Išteklių neįtraukimas į eilę
Automatinį išteklių įtraukimą į eilę galima išjungti naudojant nustatymą assets/enqueue. Tai naudinga, jei norite patys tvarkyti visų išteklių įtraukimą į eilę.
add_filter('blockstudio/settings', function($settings) {
$settings['assets']['enqueue'] = false;
return $settings;
});
Kiekvienam blokui atskirai
Jei bloko šablonas nieko negrąžina, Blockstudio neįtrauks į eilę jokių to bloko išteklių. Šis būdas patogus, kai norite išjungti įtraukimą į eilę, jei tenkinama tam tikra sąlyga.
PHP
<?php
if ( !$a['slides'] ) {
// or return '';
return false;
}
?>
<div>my slider</div>
Twig
{% if not a.slides %}
<div>my slider</div>
{% endif %}