Registrera tillgångar
Blockstudio lägger automatiskt till alla filer som slutar på .css, .scss och .js i kön när blocket används på en sida. Du kan ange hur tillgångarna ska läggas i kön genom att använda ett av följande filnamn. * är ett jokertecken som kan ersättas med valfri text.
I blockfilerna CSS och SCSS ersätts %selector% med blockets avgränsande wrapperklass. Det gör att du kan välja samma element som får bs_get_scoped_class(), även när filen inte är en avgränsad tillgång.
| Mönster | Beteende |
|---|---|
*.(s)css |
Läggs i kön som en <link>-tagg i redigeraren och på webbplatsens framsida |
*.inline.(s)css |
Innehållet läggs i en infogad <style>-tagg i redigeraren och på webbplatsens framsida |
*.editor.(s)css |
Läggs i kön som en <link>-tagg endast i redigeraren |
*.scoped.(s)css |
Det avgränsade innehållet läggs i en infogad <style>-tagg i redigeraren och på webbplatsens framsida |
*.js |
Läggs i kön som en <script>-tagg i redigeraren och på webbplatsens framsida |
*.inline.js |
Innehållet läggs i en infogad <script>-tagg i redigeraren och på webbplatsens framsida |
*.editor.js |
Läggs i kön som en <script>-tagg endast i redigeraren |
*.view.js |
Läggs i kön som en <script>-tagg endast på webbplatsens framsida |
Obs!
Bindestrecksnotationen (
*-inline.css,*-editor.cssosv.) stöds fortfarande för bakåtkompatibilitet men är föråldrad. Använd punktnotation för nya block.
Infogat
Infogade stilar och skript har den stora fördelen att de renderas direkt som style- eller script-taggar på sidan. Det kan snabba upp laddningen eftersom det sparar extra förfrågningar som annars skulle behöva göras.
.js-filer infogas i slutet av body.(s)css-filer infogas i slutet av head- Varje fil infogas bara en gång
Infoga små stilmallar
En *.(s)css-fil länkas som standard, vilket kostar en förfrågan per fil. Inställningen assets.inlineLimit skriver i stället ut små stilmallar infogade, enligt regeln som WordPress använder för sina egna stilar: sidans externa blockstilmallar sorteras från minst till störst och skrivs ut som <style> så länge den sammanlagda storleken håller sig inom gränsen. Alla andra filer behåller sin <link>-tagg.
{
"assets": {
"inlineLimit": 40000
}
}
Gränsen anges i byte, och 0, standardvärdet, stänger av beteendet. Den mäter den kompilerade fil som <link> skulle läsa in, minifierad när assets.minify.css är aktiverat. Endast valet mellan <link> och <style> beror på storleken. Varje tagg ligger kvar där <link> skulle ha varit, så laddningsordningen och kaskaden förblir oförändrade. Elementet behåller sitt id.
Inställningen gäller inte *.inline.(s)css– och *.scoped.(s)css-filer, som alltid är infogade, inte heller redigerar- och administratörstillgångar eller stilmallar som extraherats från importerade JavaScript-moduler. Globala stilmallar räknas som blockstilmallar. En fil förblir länkad när infogning skulle ändra den:
- Den innehåller en relativ URL i
url()eller@import, som löses mot stilmallen när den länkas och mot sidan när den infogas. Absoluta sökvägar, fullständiga URL:er,data:-URI:er och#-fragment fungerar. - Den använder
image-set()eller innehåller en avslutande sekvens</style. - Den innehåller CSS-escapes, en öppning av en HTML-kommentar eller en
@charset-deklaration. Sådana filer förblir länkade av försiktighetsskäl, för att undvika ändrad URL eller dokumenttolkning.
Använd inställningsfiltret för att ändra gränsen från PHP:
add_filter('blockstudio/settings/assets/inline_limit', fn() => 40000);
Infogat CSS blir en del av sidans HTML. En sidcache måste tömmas efter att en stilmall har ändrats, och webbläsaren kan inte cacha dessa byte mellan sidor. Därför gäller gränsen den sammanlagda storleken per sida.
Avgränsade
Avgränsade stilar infogas också, men får ett ID-prefix som är unikt för varje block. Använd funktionen bs_get_scoped_class för att lägga till klassen i mallen.
<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;
}
Ovanstående ger följande avgränsade stil:
<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>
Vanliga väljare i en avgränsad fil riktar sig fortfarande mot avkomlingar till den avgränsande wrappern. Använd %selector% när du vill formge själva wrappern.
Globala
Förutom tillgångar som är specifika för block kan du även lägga till globala tillgångar i kön. De blir då tillgängliga på alla sidor, oavsett om ett block finns där eller inte. Lägg till prefixet global- i filnamnet för att lägga en global tillgång i kön. Vilka som helst av suffixen (e.g. -inline) kan användas tillsammans.
Möjliga kombinationer:
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
Administratör
Administratörstillgångar läggs endast i kön i WordPress-administratörsområdet. Prefixet admin- används för att ange administratörstillgångar.
admin-styles.(s)cssadmin-scripts.js
Blockredigerare
Tillgångar för blockredigeraren läggs endast i kön i blockredigeraren. Prefixet block-editor- används för att ange dessa tillgångar.
block-editor-styles.(s)cssblock-editor-scripts.js
Obs!
Om WordPress inaktiverar redigerarens iframe eftersom ett block på klientsidan har registrerats med
apiVersionlägre än 3, delar redigerarens arbetsyta och WordPress administratörsgränssnitt samma dokument. Globala skript eller redigerarskript som kopplar händelser tillwindow,document,body, mushjulshändelser eller dokumentrullning bör skydda sig motbody.block-editor-pageeller utesluta WordPress-redigeringsområden som.interface-complementary-areaoch.interface-navigable-region.
Inläsningsordning
På webbplatsens framsida, när automatisk köläggning av tillgångar och utbuffring är aktiverade,
lägger Blockstudio till blockets taggar för CSS <link> och <style> i den buffrade sidan,
precis före den avslutande </head>-taggen, i stället för att registrera dem med
wp_enqueue_style(). Blockets CSS kommer därför efter de stilmallar som
WordPress redan har skrivit ut i head, inklusive tema- och tilläggsstilar
som lagts i kön med wp_enqueue_style(), oavsett köprioritet eller
beroenden. Administratörs- och block-editor--tillgångar använder i stället WordPresss köläggningssystem.
För regler med samma viktighet, kaskadlager och specificitet vinner blockets
stilmall över temats stilmall. Om du vill ändra på det kan du antingen höja
specificiteten för temats regel eller
lägga till temats stilmall efter Blockstudios head med filtret
blockstudio/render/head. Innehåll som filtret lägger till
placeras efter blocktillgångarna. Ta även bort stilmallen från kön i
WordPress så att den inte laddas två gånger.
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')) . '">';
});
Filtret head körs bara när Blockstudio buffrar sidan. Buffring är avstängd i anpassarens förhandsgranskning och när blockstudio/buffer/enabled returnerar false. bs_is_buffering() talar om vilket fall som gäller, så ett tema kan lägga till sin stilmall genom filtret när sidan buffras och köa den med WordPress annars. Svaret är tillgängligt från wp_enqueue_scripts och är false före 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);
});
Använd blockstudio/buffer/output om du behöver
ordna om det slutliga dokumentet på ett annat sätt.
Inaktivera köläggning
Automatisk köläggning av tillgångar kan inaktiveras med inställningen assets/enqueue. Det är användbart om du vill hantera all köläggning av tillgångar själv.
add_filter('blockstudio/settings', function($settings) {
$settings['assets']['enqueue'] = false;
return $settings;
});
Per block
Om en blockmall returnerar ingenting lägger Blockstudio inte några tillgångar för det blocket i kön. Det är ett praktiskt sätt att inaktivera köläggning när ett visst villkor uppfylls.
PHP
<?php
if ( !$a['slides'] ) {
// or return '';
return false;
}
?>
<div>my slider</div>
Twig
{% if not a.slides %}
<div>my slider</div>
{% endif %}