Liigu sisu juurde

Koodivälja varad

Lisaks failidena määratletud staatilistele stiilidele ja skriptidele toetab Blockstudio ka dünaamilisi varaplokke koodivälja kaudu. Olenevalt kasutusjuhtumist saab need piirata konkreetse plokiga.

Põhikasutus

Kõige lihtsamal juhul saate koodivälja sisu oma mallis käsitsi renderdada.

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>

Piiratud ulatusega valija

Teiste plokkidega konfliktide vältimiseks saate kasutada koodivälja sees muutujat %selector% ning renderdusmallis useBlockProps funktsiooni.

Koodiväljadel viitab %selector% konkreetsele ploki eksemplarile. Failides CSS ja SCSS viitab %selector% hoopis ploki ühisele piiratud ulatusega klassile.

Näide

Oletame, et soovime koodiväljas sihtida ülaltoodud näite silti h1.

CSS
%selector% h1 {
  color: red;
}

Nüüd teeb Blockstudio kolm asja:

  • Loob sellele ploki eksemplarile kordumatu ID
  • Asendab %selector% kordumatu ID-ga
  • Lisab sama valija elemendile, millel on märge useBlockProps

Lõpptulemus on umbes selline:

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

Automaatne renderdamine

Stiilisildi käsitsi lisamine iga kord võib olla tülikas. Selle lihtsustamiseks saate kasutada koodiväljal atribuuti asset.

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

See loob automaatselt koodiplokkidele, mis on märgitud kui css, sildid style ja paigutab need dokumendi päisesse. Keelena javascript-ga märgitud väljade puhul luuakse selle asemel sildid script ja paigutatakse need body-osa lõppu.

Laiendustes

Kui kasutate koodivälju laiendustes, pole atribuut asset vajalik. Blockstudio renderdab koodivälja sisu automaatselt varana, kui keel on css või javascript.

Näide

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

Lisaseadistusi pole vaja. Eelnev kuvab külgribal iga core/* ploki jaoks koodivälja ja renderdab selle sisu automaatselt lehe varana.

SCSS

Koodiväljad toetavad SCSS kompileerimist. Määrake keeleks scss ning Blockstudio kompileerib väärtuse enne selle CSS-na renderdamist läbi ScssPhp.

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

SCSS funktsioonid, näiteks muutujad, pesastamine ja miksinid, töötavad kõik:

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

  h1 {
    color: $primary;
  }

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

Redaktoris kompileeritakse SCSS reaalajas serveris, nii et näete tulemust kirjutamise ajal. Veebilehel toimub kompileerimine ploki renderdamisel.