İçeriğe geç

InnerBlocks

İç bloklar, bloklarınıza ek bloklar eklemenizi sağlar. Arka planda Blockstudio, InnerBlocks bileşenini kullanır. Lütfen her blokta yalnızca bir InnerBlocks bileşeni kullanılabileceğini unutmayın; bu, WordPress sınırlamasıdır.

Temel kullanım

InnerBlocks kullanmak için blok şablonunuza <InnerBlocks /> bileşenini ekleyin:

PHP
<InnerBlocks />

Birleştirme biçimi size kalmış. InnerBlocks bileşenini istediğiniz kadar derine iç içe yerleştirebilir veya tek başına kullanabilirsiniz.

Özellikler

allowedBlocks

allowedBlocks özelliği, InnerBlocks bileşenine hangi blokların eklenebileceğini tanımlamanızı sağlar.

PHP

PHP
<InnerBlocks allowedBlocks="<?php echo esc_attr(wp_json_encode(['core/heading', 'core/paragraph'])); ?>" />

Twig

Twig
<InnerBlocks allowedBlocks="{{ ['core/heading', 'core/paragraph']|json_encode|escape('html_attr') }}" />

allowedBlocks, sunucuda genişletilen belirteçleri de kabul eder. Belirteçler, düzenleyici şablonu almadan önce genişletilir; harfiyen yazılan blok adları değiştirilmeden kalır.

Belirteç Açıklama
namespace/* Bu ad alanındaki tüm kayıtlı bloklar
category:<slug> Bu WordPress blok kategorisindeki tüm kayıtlı bloklar
@theme Etkin temadan kaydedilmiş tüm Blockstudio bloklar

Genişletilen girdiler, yazar sırasına göre tekilleştirilir:

PHP
<InnerBlocks allowedBlocks="<?php echo esc_attr(wp_json_encode([
  'core/paragraph',
  'category:content',
  'bsui/field',
])); ?>" />

Hiçbir bloğa karşılık gelmeyen belirteçler yok sayılır. allowedBlocks yalnızca düzenleyici tarafından kullanıldığından ön yüz çıktısı değişmez.

tag

Varsayılan olarak InnerBlocks bileşeni bir div öğesi olarak oluşturulur. Bunu tag özelliğiyle değiştirebilirsiniz.

PHP
<InnerBlocks tag="section" />

template

template özelliği, InnerBlocks bileşeni için bir şablon tanımlamanızı sağlar.

PHP

PHP
<InnerBlocks template="<?php echo esc_attr(wp_json_encode([
  ['core/heading', ['placeholder' => 'Book Title']],
  ['core/paragraph', ['placeholder' => 'Summary']]
])); ?>" />

Twig

Twig
<InnerBlocks template="{{ [
  ['core/heading', { placeholder: 'Book Title' }],
  ['core/paragraph', { placeholder: 'Summary' }]
]|json_encode|escape('html_attr') }}" />

templateLock

templateLock özelliği, şablonun değiştirilip değiştirilemeyeceğini tanımlamanızı sağlar.

Değer Açıklama
contentOnly Tüm işlemleri engeller. İçeriği olmayan blok türleri liste görünümünde gizlenir. Alt bloklar bu kısıtlamayı geçersiz kılamaz.
all Tüm işlemleri engeller. Blok eklenemez, taşınamaz veya silinemez.
insert Blok eklenmesini veya kaldırılmasını engeller, ancak mevcut blokların taşınmasına izin verir.
false Üst blokta kilitleme olsa bile kilit uygulanmasını engeller.

renderAppender

renderAppender özelliği, blok ekleyici türünü tanımlamanızı sağlar.

Değer Açıklama
default Varsayılan blok ekleyiciyi gösterir (paragraf bloğuna izin verildiğinde paragraf stili ekleyici)
button Ekleyici olarak + simgeli bir düğme gösterir

useBlockProps

useBlockProps, düzenleyicide InnerBlocks bileşeninin dış sarmalayıcısını kaldırır. Daha fazla bilgi için ayrıntılı bilgiyeuseBlockProps bakın.

Bağlam

Kayıt

Blockstudio, InnerBlocks bileşeni için bağlam desteği sunar. Böylece üst bloktan alt bloklara veri aktarabilirsiniz. Altyapıda WordPress çekirdek bağlam mekanizmasını kullansa da Blockstudio daha kullanışlı bir API sunar.

Bağlamda aktarılması gereken tüm öznitelikleri ayrı ayrı tanımlamak yerine, üst bloğun tüm özniteliklerine abone olabilirsiniz.

Her alt blok, düzenleyicideki ilk ön yüklemeli çizim de dâhil olmak üzere kendi üst bloğunun değerlerini alır. Bir sağlayıcının alanlarını güncellemek, önceki çizim hâlâ yükleniyor olsa bile düzenleyicideki alt bloklarını günceller. Farklı sağlayıcıların altındaki aynı alt bloklar, bağlamı dikkate alan önbelleğe alınmış çizimlerini ayrı tutar.

Örneğin, aşağıdaki gibi bir kapsayıcı blok düzeniniz olduğunu varsayalım:

JSON
{
  "$schema": "https://blockstudio.dev/schema/block",
  "name": "blockstudio/container",
  "title": "Container",
  "category": "design",
  "icon": "star-filled",
  "description": "Container block.",
  "blockstudio": {
    "attributes": [
      {
        "id": "full-width",
        "type": "toggle",
        "label": "Makes section full width"
      }
    ]
  }
}

Alt bloğunuzda, blok şablonunuzdaki tüm üst blok özniteliklerine erişmek için üst blok adını usesContext özelliğiyle kullanmanız yeterlidir.

JSON
{
  "$schema": "https://blockstudio.dev/schema/block",
  "name": "blockstudio/element",
  "title": "Element",
  "category": "design",
  "icon": "star-filled",
  "description": "Element block.",
  "usesContext": ["blockstudio/container"],
  "parent": ["blockstudio/container"],
  "blockstudio": true
}

Şablonlar

Tüm üst blok özniteliklerine erişmek için $context ve $c değişkenleri blok şablonlarınızda kullanılabilir. Üst blok verileri değişirse alt bloklar düzenleyicide otomatik olarak yeniden yüklenir.

PHP

PHP
<?php $container = $context['blockstudio/container']; ?>

<h1>
  <?php echo $container['full-width']
      ? 'is full width'
      : 'no full width'; ?>
</h1>

Twig

Twig
{% set container = context['blockstudio/container'] %}

<h1>
  {{ container['full-width']
      ? 'is full width'
      : 'no full width' }}
</h1>

Ön Uç Sarmalayıcısı

InnerBlocks, düzenleyicide alt öğelerinin çevresinde bir sarmalayıcı öğe oluşturmalıdır; ancak blockstudio/blocks/components/inner_blocks/frontend/wrap filtresi kullanılarak bu öğe ön uçtan kaldırılabilir.

PHP
add_filter('blockstudio/blocks/components/inner_blocks/frontend/wrap', function($wrap, $block) {
  return false; // Remove wrapper
}, 10, 2);

Erken Döndürme

Bloğunuzun render yönteminden erken dönmek istiyorsanız $innerBlocks değişkeninin boş olup olmadığını denetleyebilirsiniz. İç blok yoksa hiçbir şey çizmek istemediğinizde bu kullanışlı olur.

PHP
<?php if (strip_tags($innerBlocks) === '') {
  return;
} ?>
<InnerBlocks tag="section" />

<InnerBlocks/> her zaman boş bir paragraf etiketi oluşturacağından, içeriğin boş olup olmadığını denetlemek için strip_tags işlevini kullanabilirsiniz.

Dinamik Şablonlar

Seç ve Radyo alan türleri, alan değerine bağlı olarak InnerBlocks şablonunun dinamik olarak oluşturulmasını destekler. Bu, kullanıcının InnerBlocks bileşeni için farklı bir şablon seçmesine izin vermek istediğinizde kullanışlıdır.

Bunu yapmak için şablonu içeren bir innerBlocks anahtarını seçenekler dizisine eklemeniz yeterlidir:

JSON
{
  "$schema": "https://blockstudio.dev/schema/block",
  "name": "blockstudio/dynamic-layout",
  "title": "Dynamic Layout",
  "blockstudio": {
    "attributes": [
      {
        "id": "layout",
        "type": "select",
        "label": "Layout",
        "options": [
          {
            "value": "1",
            "label": "Two Columns",
            "innerBlocks": [
              {
                "name": "core/columns",
                "innerBlocks": [
                  {
                    "name": "core/column",
                    "innerBlocks": [
                      {
                        "name": "core/heading",
                        "attributes": {
                          "content": "Left Heading",
                          "level": 1
                        }
                      }
                    ]
                  },
                  {
                    "name": "core/column",
                    "innerBlocks": [
                      {
                        "name": "core/heading",
                        "attributes": {
                          "content": "Right Heading",
                          "level": 1
                        }
                      }
                    ]
                  }
                ]
              }
            ]
          },
          {
            "value": "2",
            "label": "Single Column",
            "innerBlocks": [
              {
                "name": "core/heading",
                "attributes": {
                  "content": "Main Heading",
                  "level": 1
                }
              },
              {
                "name": "core/paragraph",
                "attributes": {
                  "content": "Main content goes here."
                }
              }
            ]
          }
        ],
        "allowNull": "Select a layout"
      }
    ]
  }
}

Blok Bağlamı ve İletişim

Üst ve alt blokların bağlam kullanarak verileri nasıl paylaştığını öğrenin.