İçeriğe geç

Kod Alanı Varlıkları

Dosyalar biçimindeki statik stiller ve betiklerin yanı sıra Blockstudio, kod alanı aracılığıyla dinamik varlık bloklarını da destekler. Kullanım durumunuza bağlı olarak bunları blok kapsamında tutabilirsiniz.

Temel kullanım

En temel düzeyde, kod alanı içeriğini şablonunuzda elle oluşturabilirsiniz.

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>

Kapsamlı seçici

Diğer bloklarla çakışmaları önlemek için, oluşturma şablonunuzda useBlockProps ile birlikte kod alanının içinde %selector% değişkenini kullanabilirsiniz.

Kod alanlarında %selector%, tekil blok örneğini hedefler. CSS ve SCSS dosyalarında ise %selector%, bunun yerine bloğun ortak kapsamlı sınıfını hedefler.

Örnek

Yukarıdaki örnekteki h1 etiketini kod alanımızda hedeflemek istediğimizi varsayalım.

CSS
%selector% h1 {
  color: red;
}

Şimdi Blockstudio üç şey yapacak:

  • Bu blok örneği için benzersiz bir kimlik oluşturur
  • %selector% ifadesini benzersiz kimlikle değiştirir
  • Aynı seçiciyi useBlockProps ile işaretlenmiş öğeye ekler

Son çıktı şöyle görünür:

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

Otomatik oluşturma

Stil etiketini her seferinde elle oluşturmak zahmetli olabilir. Bu süreci kolaylaştırmak için kod alanında asset özniteliğini kullanabilirsiniz.

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

Bu, css olarak işaretlenmiş kod blokları için otomatik olarak style etiketleri oluşturur ve bunları belgenin head bölümüne taşır. Dil olarak javascript işaretlenmiş alanlar içinse bunun yerine script etiketleri oluşturulur ve body bölümünün sonuna yerleştirilir.

Eklentilerde

eklenti içinde kod alanları kullanırken asset özniteliği gerekli değildir. Dil css veya javascript ise Blockstudio kod alanının içeriğini otomatik olarak bir varlık olarak oluşturur.

Örnek

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

Ek yapılandırma gerekmez. Yukarıdaki yapı, kenar çubuğunda her core/* bloğu için bir kod alanı gösterir ve içeriği otomatik olarak sayfaya varlık olarak ekler.

SCSS

Kod alanları SCSS derlemesini destekler. Dili scss olarak ayarlayın; Blockstudio, değeri ScssPhp üzerinden derleyip CSS olarak oluşturur.

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

SCSS değişkenler, iç içe yapı ve mixin’ler gibi özelliklerin tümü çalışır:

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

  h1 {
    color: $primary;
  }

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

Düzenleyicide SCSS sunucu tarafında gerçek zamanlı olarak derlenir; böylece yazdıkça sonucu görürsünüz. Ön yüzde derleme, blok oluşturulurken gerçekleşir.