Pāriet uz saturu

Resursu reģistrēšana

Blockstudio automātiski pievienos rindai visus failus, kuru nosaukums beidzas ar .css, .scss un .js, kad jūsu bloks tiek izmantots lapā. Resursu pievienošanas rindai darbību var definēt, izmantojot kādu no tālāk norādītajiem failu nosaukumiem. * ir aizstājējzīme, ko var aizstāt ar jebkuru jūsu izvēlētu virkni.

Bloka CSS un SCSS failos %selector% izvēršas par bloka tvēruma apvalka klasi. Tādējādi var atlasīt to pašu elementu, kas saņem bs_get_scoped_class(), pat tad, ja fails nav tvēruma resurss.

Raksts Darbība
*.(s)css Pievieno rindai kā <link> tagu redaktorā un vietnes priekšpusē
*.inline.(s)css Pievieno saturu iekļautā <style> tagā redaktorā un vietnes priekšpusē
*.editor.(s)css Pievieno rindai kā <link> tagu tikai redaktorā
*.scoped.(s)css Pievieno tvēruma saturu iekļautā <style> tagā redaktorā un vietnes priekšpusē
*.js Pievieno rindai kā <script> tagu redaktorā un vietnes priekšpusē
*.inline.js Pievieno saturu iekļautā <script> tagā redaktorā un vietnes priekšpusē
*.editor.js Pievieno rindai kā <script> tagu tikai redaktorā
*.view.js Pievieno rindai kā <script> tagu tikai vietnes priekšpusē

Piezīme

Defises pieraksts (*-inline.css, *-editor.css u.c.) joprojām tiek atbalstīts atpakaļsaderības nolūkā, taču tas ir novecojis. Jauniem blokiem izmantojiet punkta pierakstu.

Iekļautie resursi

Iekļautu stilu un skriptu galvenā priekšrocība ir tāda, ka tie tiek renderēti tieši kā stila vai skripta tagi lapā. Tas var paātrināt ielādi, jo nav jāveic papildu pieprasījumi.

  • .js faili tiek iekļauti body sadaļas beigās
  • .(s)css faili tiek iekļauti head sadaļas beigās
  • Katrs fails tiek iekļauts tikai vienreiz

Nelielu stilu lapu iekļaušana

*.(s)css fails pēc noklusējuma tiek piesaistīts, un par katru failu tiek veikts viens pieprasījums. Iestatījums assets.inlineLimit tā vietā izvada nelielas stilu lapas tieši lapā, ievērojot noteikumu, ko WordPress kodols piemēro saviem stiliem: lapas ārējās bloku stilu lapas tiek kārtotas no mazākās līdz lielākajai un izvadītas kā <style>, ja to kopējais izmērs nepārsniedz ierobežojumu. Katram pārējam failam paliek tā <link> tags.

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

Ierobežojums ir norādīts baitos, un 0 — noklusējuma vērtība — šo darbību izslēdz. Tiek mērīts kompilētais fails, ko ielādētu <link>; ja assets.minify.css ir ieslēgts, tas ir minificēts. No izmēra ir atkarīga tikai izvēle starp <link> un <style>. Katrs tags paliek vietā, kur būtu bijis <link>, tāpēc ielādes secība un kaskāde nemainās. Elements saglabā savu id.

Iestatījums neattiecas uz *.inline.(s)css un *.scoped.(s)css failiem, kas vienmēr tiek iekļauti, uz redaktora un administrēšanas līdzekļiem vai stilu lapām, kas iegūtas no importētiem JavaScript moduļiem. Globālās stilu lapas tiek skaitītas tāpat kā bloku stilu lapas. Fails paliek piesaistīts, ja iekļaušana mainītu tā darbību:

  • Tajā ir relatīvs URL, kas atrodas url() vai @import un piesaistītā veidā tiek atrisināts attiecībā pret stilu lapu, bet iekļautā veidā — attiecībā pret lapu. Absolūtie ceļi, pilnie URL, data: URI un # fragmenti ir pieļaujami.
  • Tajā tiek izmantots image-set() vai ir ietverta noslēdzošā secība </style.
  • Tajā ir CSS atsoļi, komentāra sākums HTML vai deklarācija @charset. Šie faili piesardzības nolūkos paliek piesaistīti, lai neriskētu mainīt URL vai dokumenta parsēšanu.

Izmantojiet iestatījuma filtru, lai mainītu ierobežojumu no PHP:

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

Iekļautais CSS kļūst par lapas HTML daļu. Pēc stilu lapas maiņas lapas kešatmiņa ir jāiztīra, un pārlūkprogramma nevar kešot šos baitus starp lapām, tāpēc ierobežojums attiecas uz katras lapas kopējo izmēru.

Tvērums

Arī tvēruma stili tiek iekļauti, taču tiem ir pievienots ID, kas katram blokam ir unikāls. Izmantojiet funkciju bs_get_scoped_class, lai pievienotu klasi veidnei.

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

Iepriekš minētais veido šādu tvēruma stilu:

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>

Parastie selektori tvēruma failā joprojām atlasa tvēruma apvalka pēctečus. Izmantojiet %selector%, ja vēlaties veidot paša apvalka stilu.

Globālie resursi

Papildus blokiem paredzētajiem resursiem var pievienot rindai arī globālos resursus, kas būs pieejami visās lapās neatkarīgi no tā, vai tajās ir bloks. Lai pievienotu rindai globālu resursu, faila nosaukumam pievienojiet prefiksu global-. Var kombinēt jebkuru sufiksu (e.g. -inline).

Iespējamās kombinācijas:

  • 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

Administrēšana

Administrēšanas resursi tiek pievienoti rindai tikai WordPress administrēšanas apgabalā. Administrēšanas resursu apzīmēšanai izmanto prefiksu admin-.

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

Bloku redaktors

Bloku redaktora resursi tiek pievienoti rindai tikai bloku redaktorā. Bloku redaktora resursu apzīmēšanai izmanto prefiksu block-editor-.

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

Piezīme

Ja WordPress atspējo redaktora iframe, jo klienta puses bloks ir reģistrēts ar apiVersion zemāku par 3, redaktora audeklam un WordPress administrēšanas saskarnei ir kopīgs dokuments. Globālajiem vai redaktora skriptiem, kas piesaista notikumus pie window, document, body, peles ritenīša notikumiem vai dokumenta ritināšanas, jāņem vērā body.block-editor-page vai jāizslēdz WordPress redaktora apgabali, piemēram, .interface-complementary-area un .interface-navigable-region.

Ielādes secība

Vietnes priekšpusē, ja ir iespējota automātiska resursu pievienošana rindai un izvades buferēšana, Blockstudio pievieno bloka CSS <link> un <style> tagus buferētajai lapai tieši pirms noslēdzošā </head> taga, nevis reģistrē tos ar wp_enqueue_style(). Tāpēc bloka CSS tiek ievietots pēc stilu lapām, ko WordPress jau ir izvadījis galvenē, tostarp motīvu un spraudņu stiliem, kas pievienoti rindai ar wp_enqueue_style(), neatkarīgi no to pievienošanas rindai prioritātes vai atkarībām. Administrēšanas un block-editor- resursiem tiek izmantota WordPress pievienošanas rindai sistēma.

Ja noteikumiem ir vienāda nozīmība, kaskādes slānis un specifiskums, bloka stilu lapa prevalē pār motīva stilu lapu. Lai to mainītu, palieliniet motīva noteikuma specifiskumu vai pievienojiet motīva stilu lapu galvenei Blockstudio, ko ģenerē blockstudio/render/head filtrs. Filtra pievienotais saturs tiek ievietots pēc bloka resursiem. Noņemiet stilu lapu no rindas arī ar WordPress, lai tā netiktu ielādēta divreiz.

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

Filtrs head darbojas tikai tad, kad Blockstudio buferē lapu. Buferēšana ir izslēgta Customizer priekšskatījumā un tad, kad blockstudio/buffer/enabled atgriež false. bs_is_buffering() norāda, kurš gadījums ir spēkā, tāpēc tēma var pievienot savu stilu lapu, izmantojot filtru, kad lapa tiek buferēta, un citos gadījumos pievienot to ielādei ar WordPress. Atbilde ir pieejama, sākot ar wp_enqueue_scripts, un ir false pirms 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);
});

Ja dokumenta galīgā secība jāpārkārto citādi, izmantojiet blockstudio/buffer/output.

Pievienošanas rindai atspējošana

Automātisku resursu pievienošanu rindai var atspējot, izmantojot iestatījumu assets/enqueue. Tas noder, ja vēlaties paši pārvaldīt visu resursu pievienošanu rindai.

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

Katram blokam

Ja bloka veidne neatgriež neko, Blockstudio nepievienos rindai resursus šim konkrētajam blokam. Šī metode ir ērta, lai atspējotu pievienošanu rindai, ja ir izpildīts noteikts nosacījums.

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