Gå til indhold

Registrering af aktiver

Blockstudio føjer automatisk alle filer, der slutter på .css, .scss og .js, til køen, når din blok bruges på en side. Du kan bestemme, hvordan aktiver tilføjes til køen, ved at bruge et af følgende filnavne. * er et jokertegn, som kan erstattes med en valgfri streng.

I blokkens CSS- og SCSS-filer udvides %selector% til blokkens afgrænsede wrapperklasse. Det lader dig målrette det samme element, som modtager bs_get_scoped_class(), også når filen ikke er et afgrænset aktiv.

Mønster Adfærd
*.(s)css Tilføjes som et <link>-tag i editoren og på frontend
*.inline.(s)css Indholdet føjes til et inline-<style>-tag i editoren og på frontend
*.editor.(s)css Tilføjes som et <link>-tag kun i editoren
*.scoped.(s)css Afgrænset indhold føjes til et inline-<style>-tag i editoren og på frontend
*.js Tilføjes som et <script>-tag i editoren og på frontend
*.inline.js Indholdet føjes til et inline-<script>-tag i editoren og på frontend
*.editor.js Tilføjes som et <script>-tag kun i editoren
*.view.js Tilføjes som et <script>-tag kun på frontend

Bemærk

Bindestregsnotationen (*-inline.css, *-editor.css osv.) understøttes stadig af hensyn til bagudkompatibilitet, men er forældet. Brug punktnotation i nye blokke.

Inline

Inline-typografier og scripts gengives direkte som style- eller script-tags på siden. Det kan gøre indlæsningen hurtigere, fordi det sparer de ekstra forespørgsler, der ellers ville være nødvendige.

  • .js-filer indsættes inline sidst i body
  • .(s)css-filer indsættes inline sidst i head
  • Hver fil indsættes kun inline én gang

Inline-små stylesheets

En *.(s)css-fil linkes som standard, hvilket koster én forespørgsel pr. fil. Indstillingen assets.inlineLimit indsætter i stedet små stylesheets inline efter den regel, som WordPress core bruger til sine egne stilarter: sidens eksterne blokstylesheets sorteres fra mindst til størst og indsættes som <style>, så længe den løbende sum er inden for grænsen. Alle øvrige filer beholder deres <link>-tag.

JSON
{
  "assets": {
    "inlineLimit": 40000
  }
}

Grænsen er angivet i bytes, og 0, standardværdien, slår funktionen fra. Den måler den kompilerede fil, som <link> ville indlæse, minificeret når assets.minify.css er slået til. Kun valget mellem <link> og <style> afhænger af størrelsen. Hvert tag forbliver dér, hvor <link> ellers ville have været, så indlæsningsrækkefølgen og kaskaden er uændrede. Elementet beholder sin id.

Indstillingen gælder ikke for *.inline.(s)css– og *.scoped.(s)css-filer, som altid er inline, for editor- og adminaktiver eller for stylesheets, der udtrækkes fra importerede JavaScript-moduler. Globale stylesheets tæller som blokstylesheets. En fil forbliver linket, når inline-indsættelse ville ændre den:

  • Den indeholder en relativ URL i url() eller @import, som opløses i forhold til stylesheetet, når det linkes, og i forhold til siden, når det indsættes inline. Absolutte stier, fulde URL’er, data:-URI’er og #-fragmenter er uproblematiske.
  • Den bruger image-set() eller indeholder en afsluttende </style-sekvens.
  • Den indeholder CSS-escapes, en kommentaråbner for HTML eller en @charset-deklaration. Disse filer forbliver forsigtigt linket for at undgå at ændre URL eller dokumentparsing.

Brug indstillingsfilteret til at ændre grænsen fra PHP:

PHP
add_filter('blockstudio/settings/assets/inline_limit', fn() => 40000);

Inline-indsat CSS bliver en del af sidens HTML. Sidens cache skal tømmes, når et stylesheet ændres, og browseren kan ikke cache disse bytes mellem sider. Derfor gælder grænsen samlet pr. side.

Afgrænset

Afgrænsede typografier indsættes også inline, men får præfikset et ID, der er unikt for hver blok. Brug funktionen bs_get_scoped_class til at føje klassen til din skabelon.

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;
}

Resultatet bliver følgende afgrænsede typografi:

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>

Almindelige selektorer i en afgrænset fil målretter stadig efterkommere af den afgrænsede wrapper. Brug %selector%, hvis du vil style selve wrapperen.

Global

Ud over aktiver, der er specifikke for en blok, kan du også føje globale aktiver til køen, så de er tilgængelige på alle sider, uanset om en blok findes på siden. Du føjer et globalt aktiv til køen ved at sætte præfikset global- foran filnavnet. Alle suffikserne (e.g. -inline) kan bruges i kombination.

Mulige 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

Administration

Administrationsaktiver føjes kun til køen i administrationsområdet WordPress. Præfikset admin- bruges til at angive administrationsaktiver.

  • admin-styles.(s)css
  • admin-scripts.js

Blokeditor

Blokeditoraktiver føjes kun til køen i blokeditoren. Præfikset block-editor- bruges til at angive blokeditoraktiver.

  • block-editor-styles.(s)css
  • block-editor-scripts.js

Bemærk

Hvis WordPress deaktiverer editorens iframe, fordi en blok på klientsiden er registreret med apiVersion lavere end 3, deler editorens lærred og WordPress adminrammen det samme dokument. Globale scripts eller editorscripts, der knytter sig til window, document, body, hjulhændelser eller dokumentscroll, bør håndtere body.block-editor-page eller udelukke editorområder som WordPress, .interface-complementary-area og .interface-navigable-region.

Indlæsningsrækkefølge

På frontend, når automatisk tilføjelse af aktiver til køen og outputbuffering er aktiveret, tilføjer Blockstudio sine blok-CSS-, <link>– og <style>-tags til den buffrede side lige før det afsluttende </head>-tag i stedet for at registrere dem med wp_enqueue_style(). Blokkenes CSS kommer derfor efter typografiarkene, som WordPress allerede har skrevet i head, herunder tema- og plugin-typografier, der er føjet til køen med wp_enqueue_style(), uanset deres prioritet eller afhængigheder. Administrations- og block-editor--aktiver bruger i stedet WordPresss køsystem.

Når vigtighed, cascad lag og specificitet er ens, vinder blokkens typografiark over temaets typografiark. Du kan ændre dette ved enten at øge specificiteten for temareglen eller føje temaets typografiark til head Blockstudio, som genereres med filteret blockstudio/render/head. Indhold, der tilføjes via filteret, placeres efter blokaktiverne. Fjern også typografiarket fra WordPress, så det ikke indlæses to gange.

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')) . '">';
});

Filteret head kører kun, når Blockstudio buffer siden. Buffering er slået fra i Customizer-forhåndsvisningen, og når blockstudio/buffer/enabled returnerer false. bs_is_buffering() fortæller dig, hvilken situation du befinder dig i, så et tema kan tilføje sit stylesheet gennem filteret, når siden buffres, og sætte det i kø med WordPress ellers. Svaret er tilgængeligt fra wp_enqueue_scripts og fremefter og er false før 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);
});

Brug blockstudio/buffer/output, hvis du vil ændre rækkefølgen af det endelige dokument på en anden måde.

Deaktivering af tilføjelse til køen

Du kan deaktivere automatisk tilføjelse af aktiver til køen med indstillingen assets/enqueue. Det er nyttigt, hvis du selv vil håndtere al tilføjelse af aktiver til køen.

PHP
add_filter('blockstudio/settings', function($settings) {
  $settings['assets']['enqueue'] = false;
  return $settings;
});

Pr. blok

Hvis en blokskabelon ikke returnerer noget, tilføjer Blockstudio ingen aktiver for den pågældende blok til køen. Det er nyttigt, hvis du vil deaktivere tilføjelse til køen, når en bestemt betingelse er opfyldt.

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 %}