Pereiti prie turinio

Išteklių registravimas

Blockstudio automatiškai į eilę įtrauks visus failus, kurių pavadinimai baigiasi .css, .scss ir .js, kai jūsų blokas naudojamas puslapyje. Į eilę įtraukiamų išteklių elgseną galima apibrėžti naudojant vieną iš toliau nurodytų failų pavadinimų. * yra pakaitos simbolis, kurį galite pakeisti bet kokia pasirinkta eilute.

Bloko CSS ir SCSS failuose %selector% išplečiamas į bloko apimties apvalkalo klasę. Taip galima taikyti stilių tam pačiam elementui, kuris gauna bs_get_scoped_class(), net jei failas nėra aprėpties išteklius.

Šablonas Elgsena
*.(s)css Įtraukia kaip žymą <link> redaktoriuje ir svetainės sąsajoje
*.inline.(s)css Įtraukia turinį į įterptąją žymą <style> redaktoriuje ir svetainės sąsajoje
*.editor.(s)css Įtraukia kaip žymą <link> tik redaktoriuje
*.scoped.(s)css Įtraukia aprėpties turinį į įterptąją žymą <style> redaktoriuje ir svetainės sąsajoje
*.js Įtraukia kaip žymą <script> redaktoriuje ir svetainės sąsajoje
*.inline.js Įtraukia turinį į įterptąją žymą <script> redaktoriuje ir svetainės sąsajoje
*.editor.js Įtraukia kaip žymą <script> tik redaktoriuje
*.view.js Įtraukia kaip žymą <script> tik svetainės sąsajoje

Pastaba

Brūkšninė notacija (*-inline.css, *-editor.css ir kt.) vis dar palaikoma dėl atgalinio suderinamumo, tačiau laikoma pasenusia. Naujiems blokams naudokite taškinę notaciją.

Įterptasis turinys

Įterptieji stiliai ir scenarijai turi didelį pranašumą: jie tiesiogiai įterpiami į puslapį kaip stiliaus arba scenarijaus žymos. Tai gali pagreitinti įkėlimą, nes nebereikia siųsti papildomų užklausų.

  • .js failai įterpiami dokumento body pabaigoje
  • .(s)css failai įterpiami dokumento head pabaigoje
  • Kiekvienas failas įterpiamas tik vieną kartą

Mažų stilių lentelių įterpimas

Pagal numatytuosius nustatymus *.(s)css failas susiejamas, todėl kiekvienam failui tenka viena užklausa. Nustačius assets.inlineLimit, mažos stilių lentelės įterpiamos tiesiai į puslapį pagal taisyklę, kurią WordPress branduolys taiko savo stiliams: puslapio išorinės blokų stilių lentelės imamos nuo mažiausios iki didžiausios ir įterpiamos kaip <style>, kol jų bendra apimtis neviršija ribos. Visų kitų failų <link> žyma paliekama.

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

Riba nurodoma baitais, o 0, numatytoji reikšmė, šią funkciją išjungia. Matuojamas kompiliuotas failas, kurį įkeltų <link>, o kai assets.minify.css įjungta – jo minifikuota versija. Nuo dydžio priklauso tik tai, ar naudojama <link>, ar <style>. Kiekviena žyma lieka ten, kur būtų buvusi <link>, todėl įkėlimo tvarka ir kaskada nepakinta. Elementas išsaugo savo id.

Šis nustatymas netaikomas failams *.inline.(s)css ir *.scoped.(s)css, kurie visada įterpiami tiesiai į puslapį, redaktoriaus ir administravimo ištekliams ar stilių lentelėms, išskirtoms iš importuotų JavaScript modulių. Visuotinės stilių lentelės skaičiuojamos kaip blokų stilių lentelės. Failas paliekamas susietas, jei jį įterpus tiesiai į puslapį pasikeistų:

  • Jame yra santykinis URL, esantis url() arba @import. Kai failas susietas, kelias nustatomas pagal stilių lentelę, o įterpus tiesiai į puslapį – pagal patį puslapį. Absoliutūs keliai, pilni URL adresai, data: URI ir # fragmentai tinka.
  • Jame naudojamas image-set() arba yra uždarymo seka </style.
  • Jame yra CSS pabėgimo sekų, komentaro pradžios žymuo HTML arba deklaracija @charset. Siekiant išvengti pakitusio URL arba dokumento analizavimo, tokie failai atsargumo sumetimais paliekami susieti.

Norėdami pakeisti ribą, naudokite nustatymo filtrą; numatytoji reikšmė yra PHP:

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

Įterptas CSS tampa puslapio HTML dalimi. Pakeitus stilių lentelę reikia išvalyti puslapio podėlį, o naršyklė negali podėlyje išsaugoti šių baitų ir panaudoti jų kituose puslapiuose, todėl nustatoma bendra riba kiekvienam puslapiui.

Aprėptis

Aprėpties stiliai taip pat įterpiami, tačiau jiems suteikiamas kiekvienam blokui unikalus ID kaip priešdėlis. Naudokite funkciją bs_get_scoped_class, kad pridėtumėte klasę prie šablono.

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

Aukščiau pateiktas kodas sukurs tokį aprėpties stilių:

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>

Aprėpties faile esantys įprasti selektoriai vis tiek taikomi aprėpties apvalkalo elementų palikuonims. Norėdami formatuoti patį apvalkalą, naudokite %selector%.

Visuotiniai ištekliai

Be konkretaus bloko išteklių, galima į eilę įtraukti ir visuotinius išteklius, kurie bus pasiekiami visuose puslapiuose, net jei juose nėra jokio bloko. Norėdami įtraukti visuotinį išteklių į eilę, prie failo pavadinimo pridėkite priešdėlį global-. Galima naudoti bet kurį priesagų derinį (e.g. -inline).

Galimi deriniai:

  • 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

Administravimas

Administravimo ištekliai į eilę įtraukiami tik WordPress administravimo srityje. Administravimo ištekliams apibrėžti naudojamas priešdėlis admin-.

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

Blokų redaktorius

Blokų redaktoriaus ištekliai į eilę įtraukiami tik blokų redaktoriuje. Blokų redaktoriaus ištekliams apibrėžti naudojamas priešdėlis block-editor-.

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

Pastaba

Jei WordPress išjungia redaktoriaus iframe, nes kliento pusėje registruotas blokas su apiVersion mažesniu nei 3, redaktoriaus drobė ir WordPress administravimo sąsajos elementai naudoja tą patį dokumentą. Visuotiniai arba redaktoriaus scenarijai, kurie susiejami su window, document, body, ratuko įvykiais arba dokumento slinkimu, turėtų patikrinti, ar įvykis kilo dėl body.block-editor-page, arba neįtraukti WordPress redaktoriaus sričių, pavyzdžiui, .interface-complementary-area ir .interface-navigable-region.

Įkėlimo tvarka

Svetainės sąsajoje, kai įjungtas automatinis išteklių įtraukimas į eilę ir išvesties buferizavimas, Blockstudio į buferizuojamą puslapį įterpia bloko CSS <link> ir <style> žymas prieš pat uždarymo žymą </head>, užuot jas registravęs per wp_enqueue_style(). Todėl bloko CSS įkeliamas po stilių lentelių, kurias WordPress jau įterpė į antraštę, įskaitant temų ir įskiepių stilius, įtrauktus į eilę naudojant wp_enqueue_style(), neatsižvelgiant į jų įtraukimo į eilę prioritetą ar priklausomybes. Administravimo ir block-editor- ištekliai naudoja įtraukimo į eilę sistemą WordPress.

Esant vienodam svarbos lygiui, kaskados sluoksniui ir specifiškumui, bloko stilių lentelė turi pirmenybę prieš temos stilių lentelę. Norėdami pakeisti šią tvarką, padidinkite temos taisyklės specifiškumą arba pridėkite temos stilių lentelę į head, kurį generuoja Blockstudio, naudodami filtrą blockstudio/render/head. Filtru pridėtas turinys pateikiamas po bloko išteklių. Taip pat pašalinkite stilių lentelę iš WordPress eilės, kad ji nebūtų įkeliama du kartus.

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

Filtras head veikia tik tada, kai Blockstudio buferizuoja puslapį. Peržiūrint „Customizer“ puslapio buferizavimas išjungtas, taip pat jis išjungtas, kai blockstudio/buffer/enabled sąsaja grąžina false. bs_is_buffering() nurodo, kuris atvejis taikomas, todėl tema gali per filtrą pridėti stilių lentelę, kai puslapis buferizuojamas, o kitu atveju įtraukti ją į eilę naudodama WordPress. Atsakymą galima gauti nuo wp_enqueue_scripts ir jis yra false prieš 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);
});

Jei reikia kitaip pertvarkyti galutinį dokumentą, naudokite blockstudio/buffer/output.

Išteklių neįtraukimas į eilę

Automatinį išteklių įtraukimą į eilę galima išjungti naudojant nustatymą assets/enqueue. Tai naudinga, jei norite patys tvarkyti visų išteklių įtraukimą į eilę.

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

Kiekvienam blokui atskirai

Jei bloko šablonas nieko negrąžina, Blockstudio neįtrauks į eilę jokių to bloko išteklių. Šis būdas patogus, kai norite išjungti įtraukimą į eilę, jei tenkinama tam tikra sąlyga.

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