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:
<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
<InnerBlocks allowedBlocks="<?php echo esc_attr(wp_json_encode(['core/heading', 'core/paragraph'])); ?>" />
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:
<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.
<InnerBlocks tag="section" />
template
template özelliği, InnerBlocks bileşeni için bir şablon tanımlamanızı sağlar.
PHP
<InnerBlocks template="<?php echo esc_attr(wp_json_encode([
['core/heading', ['placeholder' => 'Book Title']],
['core/paragraph', ['placeholder' => 'Summary']]
])); ?>" />
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:
{
"$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.
{
"$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 $container = $context['blockstudio/container']; ?>
<h1>
<?php echo $container['full-width']
? 'is full width'
: 'no full width'; ?>
</h1>
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.
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 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:
{
"$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"
}
]
}
}
Üst ve alt blokların bağlam kullanarak verileri nasıl paylaştığını öğrenin.