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.cssu.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.
.jsfaili tiek iekļauti body sadaļas beigās.(s)cssfaili 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.
{
"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@importun 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:
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.
<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;
}
Iepriekš minētais veido šādu tvēruma stilu:
<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)cssglobal-styles.inline.(s)cssglobal-styles.editor.(s)cssglobal-styles.scoped.(s)cssglobal-scripts.jsglobal-scripts.inline.jsglobal-scripts.editor.jsglobal-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)cssadmin-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)cssblock-editor-scripts.js
Piezīme
Ja WordPress atspējo redaktora iframe, jo klienta puses bloks ir reģistrēts ar
apiVersionzemāku par 3, redaktora audeklam un WordPress administrēšanas saskarnei ir kopīgs dokuments. Globālajiem vai redaktora skriptiem, kas piesaista notikumus piewindow,document,body, peles ritenīša notikumiem vai dokumenta ritināšanas, jāņem vērābody.block-editor-pagevai jāizslēdz WordPress redaktora apgabali, piemēram,.interface-complementary-areaun.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.
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.
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.
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
if ( !$a['slides'] ) {
// or return '';
return false;
}
?>
<div>my slider</div>
Twig
{% if not a.slides %}
<div>my slider</div>
{% endif %}