Koodikentän resurssit
Staattisten tyylien ja skriptien tiedostojen lisäksi Blockstudio tukee myös dynaamisia resurssilohkoja koodikentän avulla. Käyttötapauksesta riippuen ne voi rajata koskemaan vain lohkoa.
Peruskäyttö
Yksinkertaisimmillaan voit renderöidä koodikentän sisällön manuaalisesti mallissasi.
PHP
<div useBlockProps>
<h1>My block</h1>
</div>
<style><?php echo $attributes['css']; ?></style>
Twig
<div useBlockProps>
<h1>My block</h1>
</div>
<style>{{ attributes.css }}</style>
Rajattu valitsin
Voit välttää ristiriidat muiden lohkojen kanssa käyttämällä %selector%-muuttujaa koodikentässä yhdessä useBlockProps-toiminnon kanssa renderöintimallissasi.
Koodikentissä %selector% kohdistuu yksittäiseen lohkoinstanssiin. Tiedostoissa CSS ja SCSS %selector% kohdistuu sen sijaan lohkon yhteiseen rajattuun luokkaan.
Esimerkki
Oletetaan, että haluamme kohdistaa esimerkin h1-tunnisteeseen koodikentässämme.
%selector% h1 {
color: red;
}
Blockstudio tekee nyt kolme asiaa:
- Luo yksilöllisen tunnuksen kyseiselle lohkoinstanssille
- Korvaa
%selector%-arvon yksilöllisellä tunnuksella - Lisää saman valitsimen elementtiin, jossa on merkintä
useBlockProps
Lopputulos näyttää suunnilleen tältä:
<div data-assets="c9abe0d95c2b">
<h1>My block</h1>
</div>
<style>
[data-assets='c9abe0d95c2b'] h1 {
color: red;
}
</style>
Automaattinen renderöinti
Tyylitagin manuaalinen lisääminen joka kerta voi olla hankalaa. Voit helpottaa tätä lisäämällä asset-attribuutin koodikenttään.
{
"blockstudio": {
"attributes": [
{
"type": "code",
"id": "code",
"label": "Custom CSS",
"language": "css",
"asset": true
}
]
}
}
Tämä luo automaattisesti css-merkityille koodilohkoille style-tagit ja siirtää ne dokumentin head-osaan. Kentille, joiden kieleksi on merkitty javascript, luodaan sen sijaan script-tagit, jotka sijoitetaan bodyn loppuun.
Laajennuksissa
Kun käytät koodikenttiä laajennuksissa, asset-attribuuttia ei tarvita. Blockstudio renderöi koodikentän sisällön automaattisesti resurssiksi, jos kieli on css tai javascript.
Esimerkki
{
"$schema": "https://blockstudio.dev/schema/extend",
"name": "core/*",
"blockstudio": {
"extend": true,
"attributes": [
{
"id": "customCss",
"type": "code",
"label": "Custom css",
"language": "css"
}
]
}
}
Lisämäärityksiä ei tarvita. Yllä oleva näyttää sivupalkissa koodikentän jokaiselle core/*-lohkolle ja renderöi sisällön automaattisesti sivun resurssiksi.
SCSS
Koodikentät tukevat SCSS-käännöstä. Aseta kieleksi scss, niin Blockstudio kääntää arvon ScssPhp-palvelun kautta ennen sen renderöimistä muodossa CSS.
{
"blockstudio": {
"attributes": [
{
"type": "code",
"id": "styles",
"label": "Styles",
"language": "scss",
"asset": true
}
]
}
}
SCSS-ominaisuudet, kuten muuttujat, sisäkkäisyys ja sekoitukset, toimivat kaikki:
%selector% {
$primary: #3b82f6;
h1 {
color: $primary;
}
&:hover {
background: lighten($primary, 40%);
}
}
Muokkaimessa SCSS käännetään palvelinpuolella reaaliajassa, joten näet tuloksen kirjoittaessasi. Käyttöliittymässä käännös tapahtuu lohkon renderöinnin yhteydessä.