Kódmező eszközei
A fájlokban tárolt statikus stílusok és szkriptek mellett a Blockstudio a kódmező segítségével dinamikus eszközblokkokat is támogat. A használati esettől függően ezek a blokkokra korlátozhatók.
Alapvető használat
A legegyszerűbb esetben kézzel jelenítheti meg a kódmező tartalmát a sablonban.
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>
Hatókörre korlátozott szelektor
A más blokkokkal való ütközések elkerüléséhez a kódmezőben használhatja a %selector% változót a useBlockProps mellett a renderelési sablonban.
A kódmezőkben a %selector% az egyes blokkpéldányokra vonatkozik. A CSS és SCSS fájlokban a %selector% ehelyett a blokk közös, hatókörre korlátozott osztályára vonatkozik.
Példa
Tegyük fel, hogy a fenti példában szereplő h1 taget szeretnénk megcélozni a kódmezőben.
%selector% h1 {
color: red;
}
Ekkor a Blockstudio három dolgot végez:
- Egyedi azonosítót hoz létre a blokk adott példányához
- A
%selector%helyére az egyedi azonosítót illeszti - Ugyanezt a szelektort hozzáadja a
useBlockPropsjelölésű elemhez
A végeredmény valahogy így fog kinézni:
<div data-assets="c9abe0d95c2b">
<h1>My block</h1>
</div>
<style>
[data-assets='c9abe0d95c2b'] h1 {
color: red;
}
</style>
Automatikus renderelés
A style címkét mindig kézzel megadni körülményes lehet. A folyamat egyszerűsítéséhez használhatja a asset attribútumot a kódmezőben.
{
"blockstudio": {
"attributes": [
{
"type": "code",
"id": "code",
"label": "Custom CSS",
"language": "css",
"asset": true
}
]
}
}
Ez automatikusan létrehozza a style címkéket a css jelölésű kódblokkokhoz, és áthelyezi őket a dokumentum fejlécrészébe. Azoknál a mezőknél, amelyek nyelveként a javascript van megadva, ehelyett script címkék jönnek létre, és a törzs végére kerülnek.
Bővítményekben
Ha kódmezőket használ az extensions bővítményeken belül, a asset attribútumra nincs szükség. A Blockstudio automatikusan eszközként jeleníti meg a kódmező tartalmát, ha a nyelv css vagy javascript.
Példa
{
"$schema": "https://blockstudio.dev/schema/extend",
"name": "core/*",
"blockstudio": {
"extend": true,
"attributes": [
{
"id": "customCss",
"type": "code",
"label": "Custom css",
"language": "css"
}
]
}
}
Nincs szükség további konfigurációra. A fenti beállítás minden core/* blokkhoz megjelenít egy kódmezőt az oldalsávban, és automatikusan eszközként jeleníti meg a tartalmát az oldalon.
SCSS
A kódmezők támogatják a SCSS fordítást. Állítsa a nyelvet erre: scss; ekkor a Blockstudio a megjelenítés előtt a ScssPhp segítségével fordítja le az értéket CSS formátumra.
{
"blockstudio": {
"attributes": [
{
"type": "code",
"id": "styles",
"label": "Styles",
"language": "scss",
"asset": true
}
]
}
}
A SCSS olyan funkciói is működnek, mint a változók, a beágyazás és a mixinek:
%selector% {
$primary: #3b82f6;
h1 {
color: $primary;
}
&:hover {
background: lighten($primary, 40%);
}
}
A szerkesztőben a SCSS valós időben, a szerveren fordul le, így gépelés közben látja az eredményt. A kezelőfelületen a fordítás a blokk renderelésekor történik.