Resurssien rekisteröinti
Blockstudio lisää automaattisesti jonoon kaikki tiedostot, joiden päätteenä on .css, .scss tai .js, kun lohkoa käytetään sivulla. Resurssien jonoon lisäämistä voi ohjata käyttämällä jotakin seuraavista tiedostonimistä. * on jokerimerkki, jonka voi korvata millä tahansa valitsemallasi merkkijonolla.
Lohkon CSS- ja SCSS-tiedostoissa %selector% muuttuu lohkon rajatuksi ympäröiväksi luokaksi. Näin voit kohdistaa tyylit samaan elementtiin, johon bs_get_scoped_class() kohdistuu, vaikka tiedosto ei olisi rajattu resurssi.
| Kuvio | Toiminta |
|---|---|
*.(s)css |
Lisätään jonoon <link>-tagina muokkaimessa ja käyttöliittymässä |
*.inline.(s)css |
Sisältö lisätään muokkaimessa ja käyttöliittymässä suoraan <style>-tagiin |
*.editor.(s)css |
Lisätään jonoon <link>-tagina vain muokkaimessa |
*.scoped.(s)css |
Rajattu sisältö lisätään muokkaimessa ja käyttöliittymässä suoraan <style>-tagiin |
*.js |
Lisätään jonoon <script>-tagina muokkaimessa ja käyttöliittymässä |
*.inline.js |
Sisältö lisätään muokkaimessa ja käyttöliittymässä suoraan <script>-tagiin |
*.editor.js |
Lisätään jonoon <script>-tagina vain muokkaimessa |
*.view.js |
Lisätään jonoon <script>-tagina vain käyttöliittymässä |
Huomautus
Ajatusviivamerkintää (
*-inline.css,*-editor.cssjne.) tuetaan yhä taaksepäinyhteensopivuuden vuoksi, mutta se on vanhentunut. Käytä uusissa lohkoissa piste-merkintää.
Sisäiset resurssit
Sisäisten tyylien ja skriptien suurena etuna on, että ne renderöidään suoraan sivun style- tai script-tageina. Tämä voi nopeuttaa latautumista, sillä ylimääräisiä pyyntöjä ei tarvitse tehdä.
.js-tiedostot sisällytetään suoraan bodyn loppuun.(s)css-tiedostot sisällytetään suoraan head-osan loppuun- Kukin tiedosto sisällytetään suoraan vain kerran
Pienten tyylitiedostojen upottaminen
*.(s)css-tiedosto linkitetään oletusarvoisesti, mikä aiheuttaa yhden pyynnön tiedostoa kohden. Asetus assets.inlineLimit tulostaa sen sijaan pienet tyylitiedostot upotettuina noudattaen sääntöä, jota ydin WordPress soveltaa omiin tyyleihinsä: sivun ulkoiset lohkotyylitiedostot otetaan pienimmästä suurimpaan ja tulostetaan muodossa <style>, kunnes niiden yhteenlaskettu koko saavuttaa rajan. Kaikki muut tiedostot säilyttävät <link>-tunnisteensa.
{
"assets": {
"inlineLimit": 40000
}
}
Raja ilmoitetaan tavuina, ja arvo 0, oletusarvo, poistaa toiminnon käytöstä. Se mittaa käännetyn tiedoston, jonka <link> lataa; tiedosto minimoidaan, jos assets.minify.css on käytössä. Koko vaikuttaa vain siihen, valitaanko <link> vai <style>. Kukin tunniste pysyy siinä kohdassa, jossa <link> olisi ollut, joten latausjärjestys ja tyylien periytyminen eivät muutu. Elementti säilyttää arvonsa id.
Asetus ei koske tiedostoja *.inline.(s)css ja *.scoped.(s)css, jotka ovat aina upotettuja, editorin ja ylläpidon resursseja eikä tuoduista JavaScript-moduuleista erotettuja tyylitiedostoja. Yleiset tyylitiedostot lasketaan lohkotyylitiedostoiksi. Tiedosto säilyy linkitettynä aina, kun upottaminen muuttaisi sitä:
- Se sisältää suhteellisen URL-polun kohteessa
url()tai@import. Linkitettynä polku ratkaistaan tyylitiedoston perusteella ja upotettuna sivun perusteella. Absoluuttiset polut, täydet URL-osoitteet,data:-URI:t ja#-fragmentit käyvät. - Se käyttää arvoa
image-set()tai sisältää sulkevan</style-jakson. - Se sisältää CSS-escape-merkkejä, HTML-kommentin aloitusmerkin tai
@charset-määrittelyn. Tällaiset tiedostot pidetään varmuuden vuoksi linkitettyinä, jotta arvot URL tai dokumentin jäsennys eivät muutu.
Muuta rajaa asetussuodattimella arvosta PHP:
add_filter('blockstudio/settings/assets/inline_limit', fn() => 40000);
Upotetusta CSS-sisällöstä tulee osa sivun HTML-kokoa. Sivuvälimuisti on tyhjennettävä tyylitiedoston muuttuessa, eikä selain voi tallentaa näitä tavuja välimuistiin sivujen välillä. Siksi raja koskee sivukohtaista kokonaismäärää.
Rajatut tyylit
Myös rajatut tyylit sisällytetään suoraan sivulle, mutta niiden eteen lisätään kullekin lohkolle yksilöllinen tunniste. Lisää luokka mallipohjaan käyttämällä bs_get_scoped_class-funktiota.
<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;
}
Yllä oleva tuottaa seuraavan rajatun tyylin:
<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>
Rajatussa tiedostossa tavalliset valitsimet kohdistuvat edelleen rajatun ympäröivän elementin jälkeläisiin. Käytä %selector%-valitsinta, kun haluat tyylitellä itse ympäröivän elementin.
Yleiset resurssit
Lohkokohtaisten resurssien lisäksi voit lisätä jonoon yleisiä resursseja, jotka ovat käytettävissä kaikilla sivuilla riippumatta siitä, onko niillä lohkoa. Lisää yleinen resurssi jonoon lisäämällä tiedostonimen eteen global--etuliite. Mitä tahansa päätettä (e.g. -inline) voi käyttää yhdistelmänä.
Mahdollisia yhdistelmiä ovat:
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
Hallinta-alue
Hallinta-alueen resurssit lisätään jonoon vain WordPress-hallinta-alueella. Hallinta-alueen resurssit määritetään käyttämällä admin--etuliitettä.
admin-styles.(s)cssadmin-scripts.js
Lohkomuokkain
Lohkomuokkaimen resurssit lisätään jonoon vain lohkomuokkaimessa. Lohkomuokkaimen resurssit määritetään käyttämällä block-editor--etuliitettä.
block-editor-styles.(s)cssblock-editor-scripts.js
Huomautus
Jos WordPress poistaa editorin iframe-kehyksen käytöstä, koska asiakaspuolen lohko on rekisteröity arvolla
apiVersion, joka on pienempi kuin 3, editorin piirtoalue ja WordPress hallintaliittymä käyttävät samaa dokumenttia. Yleiset tai editorin komentosarjat, jotka käsittelevät tapahtumiawindow,documenttaibody, rullauseventtejä tai dokumentin vieritystä, tulisi suojatabody.block-editor-pagevastaan tai rajata pois editorin osat, kuten WordPress,.interface-complementary-areaja.interface-navigable-region.
Latausjärjestys
Käyttöliittymässä, kun resurssien automaattinen jonoon lisääminen ja tulostuspuskurointi ovat käytössä,
Blockstudio lisää lohkonsa CSS <link>– ja <style>-tagit puskuroituun sivuun
juuri ennen sulkevaa </head>-tagia sen sijaan, että se rekisteröisi ne
wp_enqueue_style()-toiminnolla. Lohkon CSS tulee siksi niiden tyylitiedostojen jälkeen,
joiden WordPress on jo tulostanut head-osaan, mukaan lukien teeman ja lisäosien tyylit,
jotka on lisätty jonoon wp_enqueue_style()-toiminnolla, niiden jonotusprioriteetista tai
riippuvuuksista riippumatta. Hallinta-alueen ja block-editor--resurssit käyttävät sen sijaan
WordPress-palvelun jonotusjärjestelmää.
Kun tärkeys, CSS-kaskadikerros ja tarkkuus ovat samat, lohkon tyylitiedosto voittaa teeman tyylitiedoston. Voit muuttaa tämän joko kasvattamalla teemasäännön tarkkuutta tai lisäämällä teeman tyylitiedoston head-osaan, jonka Blockstudio luo, käyttämällä blockstudio/render/head-suodatinta. Suodattimella lisättävä sisältö sijoitetaan lohkon resurssien jälkeen. Poista tyylitiedosto jonosta myös käyttämällä WordPress-toimintoa, jotta sitä ei ladata kahdesti.
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')) . '">';
});
Suodatin head toimii vain, kun Blockstudio puskuroi sivun. Puskurointi ei ole käytössä Mukauttimen esikatselussa eikä silloin, kun blockstudio/buffer/enabled palauttaa arvon false. bs_is_buffering() kertoo, kumpi tilanne on kyseessä, joten teema voi lisätä tyylitiedostonsa suodattimella, kun sivu puskuroidaan, ja lisätä sen jonoon komennolla WordPress muulloin. Vastaus on saatavilla alkaen kohdasta wp_enqueue_scripts, ja se on false ennen kohtaa 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);
});
Käytä blockstudio/buffer/output-toimintoa, jos haluat järjestää lopullisen dokumentin eri tavalla.
Jonoon lisäämisen poistaminen käytöstä
Resurssien automaattisen jonoon lisäämisen voi poistaa käytöstä assets/enqueue-asetuksella. Tästä on hyötyä, jos haluat hallita kaikkien resurssien jonoon lisäämistä itse.
add_filter('blockstudio/settings', function($settings) {
$settings['assets']['enqueue'] = false;
return $settings;
});
Lohkokohtaisesti
Jos lohkon mallipohja ei palauta mitään, Blockstudio ei lisää kyseisen lohkon resursseja jonoon. Näin jonoon lisäämisen voi poistaa käytöstä tietyn ehdon täyttyessä.
PHP
<?php
if ( !$a['slides'] ) {
// or return '';
return false;
}
?>
<div>my slider</div>
Twig
{% if not a.slides %}
<div>my slider</div>
{% endif %}