Ugrás a tartalomhoz

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

PHP
<div useBlockProps>
  <h1>My block</h1>
</div>
<style><?php echo $attributes['css']; ?></style>

Twig

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.

CSS
%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 useBlockProps jelölésű elemhez

A végeredmény valahogy így fog kinézni:

HTML
<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.

JSON
{
  "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

JSON
{
  "$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.

JSON
{
  "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:

Scss
%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.