Assets registreren
Blockstudio voegt automatisch alle bestanden met de extensie .css, .scss of .js toe aan de wachtrij wanneer je blok op een pagina wordt gebruikt. Je kunt bepalen hoe assets aan de wachtrij worden toegevoegd door een van de volgende bestandsnamen te gebruiken. * is een jokerteken dat je kunt vervangen door een zelfgekozen tekenreeks.
In blokbestanden CSS en SCSS staat %selector% voor de klassennaam van de scopewrapper van het blok. Zo kun je hetzelfde element selecteren als het element waarop bs_get_scoped_class() wordt toegepast, ook wanneer het bestand geen asset met scope is.
| Patroon | Gedrag |
|---|---|
*.(s)css |
Wordt in de editor en aan de voorkant toegevoegd als een <link>-tag |
*.inline.(s)css |
De inhoud wordt in de editor en aan de voorkant toegevoegd in een inline <style>-tag |
*.editor.(s)css |
Wordt alleen in de editor toegevoegd als een <link>-tag |
*.scoped.(s)css |
Inhoud met scope wordt in de editor en aan de voorkant toegevoegd in een inline <style>-tag |
*.js |
Wordt in de editor en aan de voorkant toegevoegd als een <script>-tag |
*.inline.js |
De inhoud wordt in de editor en aan de voorkant toegevoegd in een inline <script>-tag |
*.editor.js |
Wordt alleen in de editor toegevoegd als een <script>-tag |
*.view.js |
Wordt alleen aan de voorkant toegevoegd als een <script>-tag |
Opmerking
De streepjesnotatie (
*-inline.css,*-editor.css, enz.) wordt nog steeds ondersteund voor achterwaartse compatibiliteit, maar is verouderd. Gebruik de puntnotatie voor nieuwe blokken.
Inline
Inline stijlen en scripts hebben als groot voordeel dat ze direct als style- of script-tags in de pagina worden gerenderd. Dit kan de laadtijd verkorten, omdat er dan geen extra verzoeken nodig zijn.
.js-bestanden worden inline aan het einde van de body geplaatst.(s)css-bestanden worden inline aan het einde van de head geplaatst- Elk bestand wordt slechts één keer inline geplaatst
Kleine stylesheets inline plaatsen
Een *.(s)css-bestand wordt standaard gekoppeld, wat één verzoek per bestand kost. De instelling assets.inlineLimit plaatst kleine stylesheets in plaats daarvan inline, volgens de regel die WordPress toepast op zijn eigen stijlen: de externe blokstylesheets van een pagina worden van klein naar groot genomen en als <style> geplaatst zolang het lopende totaal binnen de limiet blijft. Elk ander bestand behoudt zijn <link>-tag.
{
"assets": {
"inlineLimit": 40000
}
}
De limiet is in bytes en 0, de standaardwaarde, schakelt het gedrag uit. De limiet meet het gecompileerde bestand dat <link> zou laden, geminificeerd wanneer assets.minify.css is ingeschakeld. Alleen de keuze tussen <link> en <style> hangt af van de grootte. Elke tag blijft staan op de plek waar <link> zou hebben gestaan, zodat de laadvolgorde en de cascade ongewijzigd blijven. Het element behoudt zijn id.
De instelling is niet van toepassing op *.inline.(s)css– en *.scoped.(s)css-bestanden, die altijd inline worden geplaatst, op assets voor de editor en beheeromgeving, of op stylesheets die uit geïmporteerde JavaScript-modules zijn gehaald. Globale stylesheets tellen mee als blokstylesheets. Een bestand blijft gekoppeld wanneer inline plaatsen het zou veranderen:
- Het bevat een relatief URL in
url()of@import, dat wordt opgelost ten opzichte van de stylesheet wanneer het bestand is gekoppeld en ten opzichte van de pagina wanneer het inline staat. Absolute paden, volledige URL’s,data:-URI’s en#-fragmenten zijn geen probleem. - Het gebruikt
image-set()of bevat een afsluitende reeks</style. - Het bevat CSS-escapes, een opener van een HTML-commentaar of een
@charset-declaratie. Deze bestanden blijven uit voorzorg gekoppeld om gewijzigde URL of documentparsing te voorkomen.
Gebruik het instellingenfilter om de limiet te wijzigen vanuit PHP:
add_filter('blockstudio/settings/assets/inline_limit', fn() => 40000);
Inline geplaatste CSS wordt onderdeel van de HTML van de pagina. Na een wijziging van een stylesheet moet de paginacache worden gewist. De browser kan die bytes bovendien niet tussen pagina’s cachen. Daarom geldt de limiet voor het totaal per pagina.
Scoped
Stijlen met scope worden ook inline toegevoegd, maar krijgen een ID-prefix die uniek is voor elk blok. Gebruik de functie bs_get_scoped_class om de klasse aan je template toe te voegen.
<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;
}
Dit levert de volgende stijl met scope op:
<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>
Gewone selectors in een bestand met scope selecteren nog steeds afstammelingen van de scopewrapper. Gebruik %selector% als je de wrapper zelf wilt stylen.
Globaal
Naast blokspecifieke assets kun je ook globale assets aan de wachtrij toevoegen. Deze zijn beschikbaar op alle pagina’s, ongeacht of er een blok aanwezig is. Voeg de prefix global- aan de bestandsnaam toe om een globale asset aan de wachtrij toe te voegen. Je kunt elke combinatie van de achtervoegsels e.g en -inline gebruiken.
Mogelijke combinaties:
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
Beheeromgeving
Beheerassets worden alleen toegevoegd in de beheeromgeving van WordPress. Gebruik de prefix admin- om beheerassets aan te geven.
admin-styles.(s)cssadmin-scripts.js
Blokeditor
Assets voor de blokeditor worden alleen in de blokeditor toegevoegd. Gebruik de prefix block-editor- om assets voor de blokeditor aan te geven.
block-editor-styles.(s)cssblock-editor-scripts.js
Opmerking
Als WordPress het editor-iframe uitschakelt omdat een client-side block is geregistreerd met
apiVersionlager dan 3, delen het editorcanvas en WordPress de beheerinterface hetzelfde document. Globale scripts of editorscripts die zijn gekoppeld aanwindow,document,body, wielgebeurtenissen of scrollen in het document moeten rekening houden metbody.block-editor-pageof editorgebieden zoals WordPress,.interface-complementary-areaen.interface-navigable-regionuitsluiten.
Laadvolgorde
Aan de voorkant voegt Blockstudio, wanneer assets automatisch aan de wachtrij worden toegevoegd en outputbuffering is ingeschakeld, de bloktags CSS, <link> en <style> vlak voor de afsluitende tag </head> toe aan de gebufferde pagina, in plaats van ze te registreren met wp_enqueue_style(). De CSS van het blok komt daardoor na de stylesheets die WordPress al in de head heeft afgedrukt, waaronder thema- en pluginstylesheets die zijn toegevoegd met wp_enqueue_style(), ongeacht hun prioriteit of afhankelijkheden in de wachtrij. Beheerassets en assets voor block-editor- gebruiken in plaats daarvan het wachtrijsysteem van WordPress.
Bij gelijke belangrijkheid, cascade layer en specificiteit krijgt de stylesheet van het blok voorrang op die van het thema. Om dit te wijzigen, kun je de specificiteit van de themaregel verhogen of de themastylesheet achteraan de head toevoegen met de filter die Blockstudio genereert: blockstudio/render/head. Inhoud die via het filter wordt toegevoegd, komt na de blokassets. Haal de stylesheet ook uit de wachtrij van WordPress, zodat deze niet twee keer wordt geladen.
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')) . '">';
});
Het filter head wordt alleen uitgevoerd wanneer Blockstudio de pagina buffert. Buffering is uitgeschakeld in de preview van de Customizer en wanneer blockstudio/buffer/enabled false retourneert. bs_is_buffering() laat zien in welke situatie je zit, zodat een thema zijn stylesheet via het filter kan toevoegen wanneer de pagina wordt gebufferd, en anders met WordPress aan de wachtrij kan toevoegen. Het antwoord is beschikbaar vanaf wp_enqueue_scripts en is false voordat template_redirect wordt uitgevoerd.
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);
});
Gebruik blockstudio/buffer/output als je het uiteindelijke document op een andere manier wilt ordenen.
Toevoegen aan de wachtrij uitschakelen
Je kunt automatisch toevoegen van assets aan de wachtrij uitschakelen met de instelling assets/enqueue. Dit is handig als je zelf alle assets aan de wachtrij wilt toevoegen.
add_filter('blockstudio/settings', function($settings) {
$settings['assets']['enqueue'] = false;
return $settings;
});
Per blok
Als een bloktemplate niets retourneert, voegt Blockstudio geen assets voor dat blok aan de wachtrij toe. Dit is handig als je onder bepaalde voorwaarden het toevoegen aan de wachtrij wilt uitschakelen.
PHP
<?php
if ( !$a['slides'] ) {
// or return '';
return false;
}
?>
<div>my slider</div>
Twig
{% if not a.slides %}
<div>my slider</div>
{% endif %}