Liigu sisu juurde

Varade registreerimine

Blockstudio lisab ploki kasutamisel lehel automaatselt järjekorda kõik failid, mille lõpus on .css, .scss ja .js. Varade järjekorda lisamist saab määrata järgmiste failinimede abil. * on metamärk, mille võib asendada teie valitud stringiga.

Ploki failides CSS ja SCSS tähistab %selector% ploki ulatusega ümbris-klassist. Nii saate sihtida sama elementi, millele rakendub bs_get_scoped_class(), isegi kui fail pole ulatusega vara.

Muster Käitumine
*.(s)css Lisatakse <link>-sildina redaktoris ja veebilehel
*.inline.(s)css Sisu lisatakse tekstisisese <style>-sildi sisse redaktoris ja veebilehel
*.editor.(s)css Lisatakse <link>-sildina ainult redaktoris
*.scoped.(s)css Ulatusega sisu lisatakse tekstisisese <style>-sildi sisse redaktoris ja veebilehel
*.js Lisatakse <script>-sildina redaktoris ja veebilehel
*.inline.js Sisu lisatakse tekstisisese <script>-sildi sisse redaktoris ja veebilehel
*.editor.js Lisatakse <script>-sildina ainult redaktoris
*.view.js Lisatakse <script>-sildina ainult veebilehel

Märkus

Sidekriipsuga tähistus (*-inline.css, *-editor.css jne) on tagasiühilduvuse huvides endiselt toetatud, kuid aegunud. Kasutage uute plokkide puhul punktiga tähistust.

Tekstisisesed varad

Tekstisiseste stiilide ja skriptide suur eelis on see, et need renderdatakse otse lehe stiili- või skriptisiltidena. See võib lühendada laadimisaega, sest säästab muidu vajalikke lisapäringuid.

  • .js-failid lisatakse tekstisiseselt body-osa lõppu
  • .(s)css-failid lisatakse tekstisiseselt head-osa lõppu
  • Iga fail lisatakse tekstisiseselt ainult üks kord

Väikeste laaditabelite tekstisisene lisamine

Vaikimisi lingitakse *.(s)css fail, mis tähendab iga faili kohta üht päringut. Seade assets.inlineLimit lisab selle asemel väikesed laaditabelid tekstisiseselt, järgides reeglit, mida WordPress rakendab oma laaditabelitele: lehe välised plokilaaditabelid võetakse väikseimast suurimani ja lisatakse kui <style>, kuni nende kogumaht jääb piirangu piiresse. Kõik teised failid säilitavad oma <link> märgendi.

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

Piirang on baitides ja 0, vaikeväärtus, lülitab selle funktsiooni välja. Mõõdetakse kompileeritud faili, mille <link> laadiks; kui assets.minify.css on sisse lülitatud, siis minimeeritud faili. Suurus määrab ainult valiku <link> ja <style> vahel. Iga märgend jääb sinna, kus oleks olnud <link>, seega laadimisjärjestus ja kaskaad ei muutu. Element säilitab oma id.

Seade ei kehti failide *.inline.(s)css ja *.scoped.(s)css kohta, mis lisatakse alati tekstisiseselt, redaktori- ega administraatorivaradele ega imporditud JavaScript moodulitest eraldatud laaditabelitele. Globaalseid laaditabeleid käsitletakse nagu plokkide laaditabeleid. Fail jääb lingituks alati, kui tekstisisene lisamine seda muudaks:

  • See sisaldab suhtelist URL väärtust url() või @import sees. Lingitud laaditabeli korral lahendatakse see laaditabeli, tekstisisese korral aga lehe suhtes. Absoluutsed teed, täielikud URL-id, data: URI-d ja # fragmendid sobivad.
  • See kasutab image-set() või sisaldab sulgevat jada </style.
  • See sisaldab CSS paomärke, kommentaari algust HTML või deklaratsiooni @charset. Need failid jäetakse ettevaatusest lingituks, et vältida URL muutmist või dokumendi parsimise häirimist.

Piirangu muutmiseks alates väärtusest PHP kasutage seadefiltrit:

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

Tekstisiseselt lisatud CSS muutub lehe HTML osaks. Laaditabeli muutmise järel tuleb lehe vahemälu tühjendada ning brauser ei saa neid baite lehtede vahel vahemällu salvestada. Seetõttu kehtib piirang kogu lehe peale.

Ulatusega stiilid

Ulatusega stiilid lisatakse samuti tekstisiseselt, kuid neile lisatakse igale plokile ainulaadne ID. Kasutage funktsiooni bs_get_scoped_class, et lisada klass mallile.

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

Eelnev annab tulemuseks järgmise ulatusega stiili:

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>

Ulatusega faili tavalised valijad sihivad endiselt ulatusega ümbrise järeltulijaid. Kasutage %selector%, kui soovite stiilida ümbrist ennast.

Globaalsed varad

Lisaks plokipõhistele varadele saab järjekorda lisada ka globaalseid varasid, mis on saadaval kõigil lehtedel, olenemata sellest, kas plokk on olemas. Globaalse vara lisamiseks lisage failinime ette prefiks global-. Kombineerida saab suvalisi järelliiteid (e.g, -inline).

Võimalikud kombinatsioonid:

  • 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

Haldusala

Haldusala varad lisatakse järjekorda ainult WordPress haldusalas. Haldusala varade määramiseks kasutatakse prefiksit admin-.

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

Plokiredaktor

Plokiredaktori varad lisatakse järjekorda ainult plokiredaktoris. Plokiredaktori varade määramiseks kasutatakse prefiksit block-editor-.

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

Märkus

Kui WordPress keelab redaktori iframe’i, sest kliendipoolne plokk on registreeritud väärtusega apiVersion alla 3, kasutavad redaktori lõuend ja WordPress haldusliides sama dokumenti. Globaalsed või redaktori skriptid, mis seovad end window, document, body, rattasündmuste või dokumendi kerimisega, peaksid arvestama väärtusega body.block-editor-page või jätma välja redaktori piirkonnad, nagu .interface-complementary-area ja .interface-navigable-region, mis kasutavad elementi WordPress.

Laadimisjärjekord

Veebilehel lisab Blockstudio automaatse varade järjekorda lisamise ja väljundi puhverdamise korral ploki CSS <link>– ja <style>-sildid puhverdatud lehele vahetult enne sulgevat </head>-silti, selle asemel et need registreerida wp_enqueue_style() abil. Seetõttu tulevad ploki CSS-stiilid pärast laaditabeleid, mille WordPress on juba päisesse väljastanud, sealhulgas teema ja plugina stiilid, mis lisati järjekorda wp_enqueue_style() abil, olenemata nende järjekorra prioriteedist või sõltuvustest. Haldusala ja block-editor- varad kasutavad selle asemel WordPress järjekorda lisamise süsteemi.

Sama tähtsuse, kaskaadikihi ja spetsiifilisusega reeglite puhul on ploki stiilitabel teema stiilitabelist ülimuslikum. Selle muutmiseks suurendage teema reegli spetsiifilisust või lisage teema stiilitabel päisesse Blockstudio, mille genereerib filtriga blockstudio/render/head. Filtriga lisatud sisu paigutatakse ploki varade järele. Tühistage laaditabeli järjekorda lisamine ka WordPress-s, et seda ei laaditaks kaks korda.

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

Filter head käivitub ainult siis, kui Blockstudio puhverdab lehte. Customizeri eelvaates ja juhul, kui blockstudio/buffer/enabledleht on puhverduses tagastab false, puhverdus ei toimi. bs_is_buffering() näitab, millise juhuga on tegu, nii et teema saab puhverduses lehe korral lisada laaditabeli filtri kaudu ja muul juhul lisada selle järjekorda funktsiooniga WordPress. Vastus on saadaval alates versioonist wp_enqueue_scripts ja see määratakse enne template_redirect käivitumist false.

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

Kui soovite lõppdokumenti teisiti ümber korraldada, kasutage blockstudio/buffer/output.

Järjekorda lisamise keelamine

Varade automaatse järjekorda lisamise saab keelata seadega assets/enqueue. See on kasulik, kui soovite kõik varad ise järjekorda lisada.

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

Ploki kaupa

Kui ploki mall ei tagasta midagi, ei lisa Blockstudio selle ploki jaoks varasid järjekorda. See on mugav viis järjekorda lisamise keelamiseks, kui teatud tingimus on täidetud.

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