Siirry sisältöön

Koodikentän resurssit

Staattisten tyylien ja skriptien tiedostojen lisäksi Blockstudio tukee myös dynaamisia resurssilohkoja koodikentän avulla. Käyttötapauksesta riippuen ne voi rajata koskemaan vain lohkoa.

Peruskäyttö

Yksinkertaisimmillaan voit renderöidä koodikentän sisällön manuaalisesti mallissasi.

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>

Rajattu valitsin

Voit välttää ristiriidat muiden lohkojen kanssa käyttämällä %selector%-muuttujaa koodikentässä yhdessä useBlockProps-toiminnon kanssa renderöintimallissasi.

Koodikentissä %selector% kohdistuu yksittäiseen lohkoinstanssiin. Tiedostoissa CSS ja SCSS %selector% kohdistuu sen sijaan lohkon yhteiseen rajattuun luokkaan.

Esimerkki

Oletetaan, että haluamme kohdistaa esimerkin h1-tunnisteeseen koodikentässämme.

CSS
%selector% h1 {
  color: red;
}

Blockstudio tekee nyt kolme asiaa:

  • Luo yksilöllisen tunnuksen kyseiselle lohkoinstanssille
  • Korvaa %selector%-arvon yksilöllisellä tunnuksella
  • Lisää saman valitsimen elementtiin, jossa on merkintä useBlockProps

Lopputulos näyttää suunnilleen tältä:

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

Automaattinen renderöinti

Tyylitagin manuaalinen lisääminen joka kerta voi olla hankalaa. Voit helpottaa tätä lisäämällä asset-attribuutin koodikenttään.

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

Tämä luo automaattisesti css-merkityille koodilohkoille style-tagit ja siirtää ne dokumentin head-osaan. Kentille, joiden kieleksi on merkitty javascript, luodaan sen sijaan script-tagit, jotka sijoitetaan bodyn loppuun.

Laajennuksissa

Kun käytät koodikenttiä laajennuksissa, asset-attribuuttia ei tarvita. Blockstudio renderöi koodikentän sisällön automaattisesti resurssiksi, jos kieli on css tai javascript.

Esimerkki

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

Lisämäärityksiä ei tarvita. Yllä oleva näyttää sivupalkissa koodikentän jokaiselle core/*-lohkolle ja renderöi sisällön automaattisesti sivun resurssiksi.

SCSS

Koodikentät tukevat SCSS-käännöstä. Aseta kieleksi scss, niin Blockstudio kääntää arvon ScssPhp-palvelun kautta ennen sen renderöimistä muodossa CSS.

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

SCSS-ominaisuudet, kuten muuttujat, sisäkkäisyys ja sekoitukset, toimivat kaikki:

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

  h1 {
    color: $primary;
  }

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

Muokkaimessa SCSS käännetään palvelinpuolella reaaliajassa, joten näet tuloksen kirjoittaessasi. Käyttöliittymässä käännös tapahtuu lohkon renderöinnin yhteydessä.