İçeriğe geç

Blok Öznitelikleri

$attributes veya $a değişkenleri yalnızca blockstudio özelliğinde kayıtlı verilere erişmenizi sağlar. Hizalama veya tipografi gibi standart WordPress blok verilerine erişmek için $block veya $b değişkenlerini kullanın.

Oluşturma

PHP

PHP
<h1>The block is aligned: <?php echo $block['align']; ?></h1>
<h1>The block is aligned: <?php echo $b['align']; ?></h1>

Twig

Twig
<h1>The block is aligned: {{ block.align }}</h1>
<h1>The block is aligned: {{ b.align }}</h1>

Varsayılanları Ayarlama

Ayrılmış Alan Kimlikleri

WordPress tarafından yönetilen öznitelikler, aynı üst düzey kimliğe sahip Blockstudio alanları olarak tanımlanmamalıdır. anchor, className, style, lock ve metadata ayrılmıştır; Blockstudio tarafından kullanılan dahili blockstudio, __BLOCKSTUDIO_KEY ve blockEditingMode öznitelikleri de öyledir.

Etkin WordPress destekleri de kendi öznitelik adlarını ayırır: geçerli olduğu durumlarda align, backgroundColor, textColor, gradient, fontSize, fontFamily, layout, borderColor, shadow ve ariaLabel. Bu özniteliklerden birinin yerel tanımı da o adı ayırır. Böylece örneğin çekirdeğin metin align değeri, bir seçim alanının seçenek nesnesiyle değiştirilmez.

Çakışan alanlar kayıt sırasında atlanır ve blok ile alanın adı belirtilerek blockstudio/error/logged üzerinden günlüğe kaydedilir (etkinse WordPress hata ayıklama günlüğüne de yazılır). Bu alanların düzenleyici denetimleri, depolama işleyicileri ve oluşturma tanımları kaydedilmez. Alanı headingAlign olarak yeniden adlandırın veya presentation gibi adlandırılmış bir grubun içine koyarak presentation_align oluşturun. Yineleyici satırı alanları kendi satırlarının içinde bulunur ve üst düzey çakışma oluşturmaz. Hizalama desteği devre dışıyken ve yerel align özniteliği yokken sıradan bir align alanı geçerliliğini korur.

Çakışma bulunan mevcut bir bloğu yükseltirken alanını yeniden adlandırın ve kaydedilmiş alan değerlerini yeni kimliğe taşıyın. Blockstudio depolanan içeriği sessizce yeniden adlandırmaz veya WordPress desteğini kaldırmaz.

Yerel Öznitelik Varsayılanları

align gibi WordPress özelliklerine varsayılan bir değer atamak için attributes anahtarının içine bir default anahtarı ekleyin:

JSON
{
  "$schema": "https://blockstudio.dev/schema/block",
  "name": "blockstudio/block",
  "title": "Native Block",
  "icon": "star-filled",
  "description": "Native Block.",
  "supports": {
    "align": ["left", "center", "right"]
  },
  "attributes": {
    "align": {
      "type": "string",
      "default": "center"
    }
  },
  "blockstudio": true
}

Kullanılabilir Blok Verileri

$block / $b değişkeni şunları içerir:

Özellik Açıklama
name Blok adı (e.g., my-theme/my-block)
title Blok başlığı
dir Blok dizini yolu
url Blok dizini URL
align Hizalama değeri (supports.align etkinse)
className Özel CSS sınıfı (supports.customClassName etkinse)
anchor HTML bağlantı/kimlik (supports.anchor etkinse)

WordPress Desteği

WordPress blok özelliklerini supports özelliği üzerinden etkinleştirin:

JSON
{
  "supports": {
    "align": true,
    "anchor": true,
    "customClassName": true,
    "color": {
      "background": true,
      "text": true
    },
    "spacing": {
      "margin": true,
      "padding": true
    },
    "typography": {
      "fontSize": true,
      "lineHeight": true
    }
  }
}

Kullanılabilir tüm seçenekler için WordPress Blok Desteği belgelerine bakın.