Pāriet uz saturu

Koda lauka aktīvi

Līdztekus statiskiem stiliem un skriptiem, kas glabājas failos, Blockstudio atbalsta arī dinamiskus aktīvu blokus, izmantojot koda lauku. Atkarībā no lietojuma tos var ierobežot līdz konkrētam blokam.

Pamata lietojums

Vienkāršākajā gadījumā veidnē varat manuāli renderēt koda lauka saturu.

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>

Ierobežots selektors

Lai izvairītos no konfliktiem ar citiem blokiem, veidnes renderēšanai kopā ar useBlockProps koda laukā varat izmantot mainīgo %selector%.

Koda laukos %selector% atlasa atsevišķu bloka instanci. Failos CSS un SCSS %selector% tā vietā atlasa bloka koplietojamo ierobežotās darbības klasi.

Piemērs

Pieņemsim, ka koda laukā vēlamies atlasīt iepriekšējā piemērā norādīto tagu h1.

CSS
%selector% h1 {
  color: red;
}

Tagad Blockstudio veiks trīs darbības:

  • Izveidos unikālu ID šai bloka instancei
  • Aizstās %selector% ar unikālo ID
  • Pievienos to pašu selektoru elementam, kas apzīmēts ar useBlockProps

Gala rezultāts būs aptuveni šāds:

HTML
<div data-assets="c9abe0d95c2b">
  <h1>My block</h1>
</div>
<style>
  [data-assets='c9abe0d95c2b'] h1 {
    color: red;
  }
</style>

Automātiska renderēšana

Stila tagu manuāla renderēšana ikreiz var būt apgrūtinoša. Lai šo procesu atvieglotu, koda laukā varat izmantot atribūtu asset.

JSON
{
  "blockstudio": {
    "attributes": [
      {
        "type": "code",
        "id": "code",
        "label": "Custom CSS",
        "language": "css",
        "asset": true
      }
    ]
  }
}

Tas automātiski izveidos style tagus koda blokiem, kas atzīmēti ar css, un pārvietos tos uz dokumenta head sadaļu. Laukiem, kuros valoda atzīmēta ar javascript, tiks izveidoti script tagi un ievietoti body sadaļas apakšā.

Paplašinājumos

Izmantojot koda laukus paplašinājumos, atribūts asset nav nepieciešams. Blockstudio automātiski renderēs koda lauka saturu kā resursu, ja valoda ir css vai javascript.

Piemērs

JSON
{
  "$schema": "https://blockstudio.dev/schema/extend",
  "name": "core/*",
  "blockstudio": {
    "extend": true,
    "attributes": [
      {
        "id": "customCss",
        "type": "code",
        "label": "Custom css",
        "language": "css"
      }
    ]
  }
}

Papildu konfigurācija nav nepieciešama. Iepriekš minētais sānjoslā parādīs koda lauku katram core/* blokam un automātiski renderēs saturu kā lapas resursu.

SCSS

Koda lauki atbalsta SCSS kompilēšanu. Iestatiet valodu uz scss, un Blockstudio pirms renderēšanas kā CSS kompilēs vērtību, izmantojot ScssPhp.

JSON
{
  "blockstudio": {
    "attributes": [
      {
        "type": "code",
        "id": "styles",
        "label": "Styles",
        "language": "scss",
        "asset": true
      }
    ]
  }
}

Darbojas visas SCSS iespējas, piemēram, mainīgie, ligzdošana un miksīni:

Scss
%selector% {
  $primary: #3b82f6;

  h1 {
    color: $primary;
  }

  &:hover {
    background: lighten($primary, 40%);
  }
}

Redaktorā SCSS tiek kompilēts servera pusē reāllaikā, tāpēc rezultātu redzat rakstīšanas laikā. Priekšpusē kompilēšana notiek bloka renderēšanas laikā.