Hoppa till innehåll

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.css osv.) 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.

JSON
{
  "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:

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.

PHP
<section class="hero <?php echo bs_get_scoped_class($b['name']); ?>">
  <h1 class="hero__title">Scope me!</h1>
</section>
CSS
%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:

HTML
<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)css
  • global-styles.inline.(s)css
  • global-styles.editor.(s)css
  • global-styles.scoped.(s)css
  • global-scripts.js
  • global-scripts.inline.js
  • global-scripts.editor.js
  • global-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)css
  • admin-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)css
  • block-editor-scripts.js

Obs!

Om WordPress inaktiverar redigerarens iframe eftersom ett block på klientsidan har registrerats med apiVersion lägre än 3, delar redigerarens arbetsyta och WordPress administratörsgränssnitt samma dokument. Globala skript eller redigerarskript som kopplar händelser till window, document, body, mushjulshändelser eller dokumentrullning bör skydda sig mot body.block-editor-page eller utesluta WordPress-redigeringsområden som .interface-complementary-area och .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.

PHP
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.

PHP
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.

PHP
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
<?php
  if ( !$a['slides'] ) {
    // or return '';
    return false;
  }
?>

<div>my slider</div>

Twig

Twig
{% if not a.slides %}
  <div>my slider</div>
{% endif %}