Pereiti prie turinio

Kodo laukų ištekliai

Be statinių stilių ir scenarijų failų, Blockstudio taip pat palaiko dinaminius išteklių blokus naudojant kodo lauką. Atsižvelgiant į poreikį, juos galima apriboti konkrečiu bloku.

Pagrindinis naudojimas

Paprasčiausiu atveju kodo lauko turinį šablone galite atvaizduoti rankiniu būdu.

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>

Aprėpties parinkiklis

Kad išvengtumėte konfliktų su kitais blokais, kodo lauke kartu su useBlockProps atvaizdavimo šablone galite naudoti kintamąjį %selector%.

Kodo laukuose %selector% nurodo konkretų bloko egzempliorių. CSS ir SCSS failuose %selector% nurodo bendrą bloko aprėpties klasę.

Pavyzdys

Tarkime, kad kodo lauke norime pasirinkti pirmiau pateiktame pavyzdyje esančią žymą h1.

CSS
%selector% h1 {
  color: red;
}

Dabar Blockstudio atliks tris veiksmus:

  • Sukurs unikalų to bloko egzemplioriaus ID
  • Pakeis %selector% unikaliu ID
  • Pridės tą patį parinkiklį prie elemento, pažymėto atributu useBlockProps

Galutinis rezultatas atrodys maždaug taip:

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

Automatinis atvaizdavimas

Visada rankiniu būdu įterpti stiliaus žymą gali būti nepatogu. Kad tai būtų paprasčiau, kodo lauke galite naudoti atributą asset.

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

Taip automatiškai sukuriamos žymos style kodo blokams, pažymėtiems kaip css, ir perkeliamos į dokumento antraštę. Laukams, kurių kalba pažymėta kaip javascript, vietoj jų sukuriamos žymos script ir įkeliamos dokumento pabaigoje, prieš uždarant body.

Plėtiniuose

Naudojant kodo laukus plėtiniuose, atributo asset nereikia. Blockstudio automatiškai pateiks kodo lauko turinį kaip išteklių, jei kalba yra css arba javascript.

Pavyzdys

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

Papildomos konfigūracijos nereikia. Aukščiau pateikta konfigūracija šoninėje juostoje rodys kodo lauką kiekvienam core/* blokui ir automatiškai pateiks jo turinį puslapyje kaip išteklių.

SCSS

Kodo laukai palaiko SCSS kompiliavimą. Nustatykite kalbą kaip scss, ir Blockstudio prieš pateikdamas reikšmę kaip CSS ją sukompiliuos per ScssPhp.

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

Veikia visos SCSS funkcijos, pavyzdžiui, kintamieji, įdėtinės konstrukcijos ir mišiniai:

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

  h1 {
    color: $primary;
  }

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

Redaktoriuje SCSS kompiliuojamas serveryje realiuoju laiku, todėl rašydami iškart matote rezultatą. Svetainės sąsajoje kompiliuojama atvaizduojant bloką.