İçeriğe geç

Öznitelikleri Kaydetme

Öznitelikler, block.json dosyanızdaki blockstudio.attributes dizisi içinde tanımlanır.

Temel Örnek

JSON
{
  "name": "my-theme/my-block",
  "title": "My Block",
  "blockstudio": {
    "attributes": [
      {
        "id": "title",
        "type": "text",
        "label": "Title"
      },
      {
        "id": "content",
        "type": "textarea",
        "label": "Content"
      }
    ]
  }
}

Öznitelik Özellikleri

Tüm öznitelikler şu özellikleri paylaşır:

Özellik Tür Açıklama
id string Öznitelik için benzersiz tanımlayıcı
type string Alan türü (text, textarea, select vb.)
label string Düzenleyicide gösterilen etiket
default mixed Özniteliğin varsayılan değeri
help string Etiketin yanında araç ipucu olarak gösterilen yardım metni
position string Alanın göründüğü yer: inspector (varsayılan) veya toolbar
conditions array Alanın gösterilmesi/gizlenmesi için koşullu mantık

Konum

Varsayılan olarak tüm alanlar blok denetçisinde (kenar çubuğunda) gösterilir. Bunu position özelliğiyle değiştirebilirsiniz:

JSON
{
  "blockstudio": {
    "attributes": [
      {
        "id": "alignment",
        "type": "select",
        "label": "Alignment",
        "position": "toolbar",
        "options": [
          { "value": "left", "label": "Left" },
          { "value": "center", "label": "Center" },
          { "value": "right", "label": "Right" }
        ]
      }
    ]
  }
}

Varsayılan Değerler

Varsayılan değerleri default özelliğiyle ayarlayın:

JSON
{
  "blockstudio": {
    "attributes": [
      {
        "id": "title",
        "type": "text",
        "label": "Title",
        "default": "Hello World"
      },
      {
        "id": "showBorder",
        "type": "toggle",
        "label": "Show Border",
        "default": true
      }
    ]
  }
}

Yardım Metni

Kullanıcılara yol göstermek için yardım metni ekleyin:

JSON
{
  "blockstudio": {
    "attributes": [
      {
        "id": "apiKey",
        "type": "text",
        "label": "API Key",
        "help": "Enter your API key from the settings page"
      }
    ]
  }
}

Özniteliklere Erişme

Şablonunuzda özniteliklere $a kısa yazımı (veya $attributes) aracılığıyla erişebilirsiniz:

PHP
<h1><?php echo $a['title']; ?></h1>
<p><?php echo $a['content']; ?></p>

Ya da Twig içinde:

Twig
<h1>{{ a.title }}</h1>
<p>{{ a.content }}</p>

Alan Kalıpları Rehberi