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.cssosv.) 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.
{
"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:
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.
<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;
}
Resultatet bliver følgende afgrænsede typografi:
<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)cssglobal-styles.inline.(s)cssglobal-styles.editor.(s)cssglobal-styles.scoped.(s)cssglobal-scripts.jsglobal-scripts.inline.jsglobal-scripts.editor.jsglobal-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)cssadmin-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)cssblock-editor-scripts.js
Bemærk
Hvis WordPress deaktiverer editorens iframe, fordi en blok på klientsiden er registreret med
apiVersionlavere end 3, deler editorens lærred og WordPress adminrammen det samme dokument. Globale scripts eller editorscripts, der knytter sig tilwindow,document,body, hjulhændelser eller dokumentscroll, bør håndterebody.block-editor-pageeller udelukke editorområder som WordPress,.interface-complementary-areaog.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.
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.
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.
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
if ( !$a['slides'] ) {
// or return '';
return false;
}
?>
<div>my slider</div>
Twig
{% if not a.slides %}
<div>my slider</div>
{% endif %}